lex-agentic-self 0.1.12 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ac6f03a82078dcd9825225bad2f7cb7a81b7ac517181beccd7b8e0e3a9fd4c5
-  data.tar.gz: '0190fc35f4bf31f56d85f7932dd94721b772bd1a8e6dd849f95f34c057d7890f'
+  metadata.gz: 53c28592aa4721c2cc7901452451b9836cad8d3ded37f83c2a8dc04aac3ba1f8
+  data.tar.gz: 29a423e61504f68cf11fd8c234f29b0d4ff654e33ea5651fd2d7739656cfb9ab
 SHA512:
-  metadata.gz: 5a8e94288b725ae83a1fbb6fc9317e830c9312535017fb772dc373a4e15c37e0b9d253dfed3f4f1ffd75001855247dc1818a6f96a5083ce0ffed45be084b0496
-  data.tar.gz: 2bc4e6f417b896828d6ec193e1710ad723f4ee969070184624b5537fc5816ae0793ba45f6b5cbe6ca444cc41a0cc76650a53ff994959629b1ba577a49eabfa47
+  metadata.gz: 38e5b0225a70847a4fb4a8d2f323f1bf1174004f16643deca0fca3567970f16fb5ee722e5e974051b42aff17c7dbb4ccdf7d1c403651c9d4228f3dec4433f7ca
+  data.tar.gz: 3bc0d255fb156a9ce05ac926ecd6c5ca15c57a0729c57de9b679ebb684748143e004bbb209433056b628b4de78f7fa0437393d428d810069b69cd3f0fa787ff0

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.1.14] - 2026-05-07
+### Fixed
+- Identity fingerprint save now warns and returns false if local persistence disconnects after previously being available.
+- Reflection health now updates trust drift and mode-pattern category scores from tick results.
+- Reflection LLM enhancer rejects arbitrary extra keyword arguments instead of forwarding them.
+
+## [0.1.13] - 2026-04-22
+### Added
+- Module-level snapshot methods (`personality_snapshot`, `reflection_snapshot`, `restore_personality`, `restore_reflections`) enabling memory↔self bridge for snapshot save/restore
+- RelationshipArc documented in CLAUDE.md
+### Fixed
+- Faraday moved from development to runtime dependency (was causing LoadError in production)
+- NarrativeSelf `record_episode` renamed to `record_narrative_self_episode` to resolve collision with NarrativeIdentity
+- Silent rescue blocks in vault_secrets, self_model, relationship_arc now log errors
+
 ## [0.1.12] - 2026-04-15
 ### Changed
 - Set `mcp_tools?`, `mcp_tools_deferred?`, and `transport_required?` to `false` — internal cognitive pipeline extension

data/README.md

@@ -1,33 +1,34 @@
 # lex-agentic-self
 
-Domain consolidation gem for self-model, identity, metacognition, and self-awareness. Bundles 16 source extensions into one loadable unit under `Legion::Extensions::Agentic::Self`.
+Domain consolidation gem for self-model, identity, metacognition, and self-awareness. Bundles 17 sub-modules into one loadable unit under `Legion::Extensions::Agentic::Self`.
 
 ## Overview
 
 **Gem**: `lex-agentic-self`
-**Version**: 0.1.12
+**Version**: 0.1.13
 **Namespace**: `Legion::Extensions::Agentic::Self`
 
 ## Sub-Modules
 
-| Sub-Module | Source Gem | Purpose |
-|---|---|---|
-| `Self::Identity` | `lex-identity` | Behavioral fingerprint (6 dimensions, entropy anomaly) + Entra ID binding |
-| `Self::Metacognition` | `lex-metacognition` | Second-order self-model — discovers loaded extensions, maps capabilities |
-| `Self::MetacognitiveMonitoring` | `lex-metacognitive-monitoring` | Continuous confidence calibration, feeling-of-knowing |
-| `Self::SelfModel` | `lex-self-model` | Stable beliefs about capabilities, limitations, and values |
-| `Self::SelfTalk` | `lex-self-talk` | IFS-inspired inner dialogue — typed turns before action |
-| `Self::Reflection` | `lex-reflection` | Post-tick meta-cognitive analysis — seven categories, EMA health scores |
-| `Self::NarrativeArc` | `lex-cognitive-narrative-arc` | McAdams narrative arc — beats, tension, resolution |
-| `Self::NarrativeIdentity` | `lex-narrative-identity` | McAdams narrative identity — the agent's life story |
-| `Self::NarrativeSelf` | `lex-narrative-self` | Minimal self vs. narrative self |
-| `Self::Architecture` | `lex-cognitive-architecture` | Meta-layer graph of cognitive subsystems — bottleneck detection |
-| `Self::Fingerprint` | `lex-cognitive-fingerprint` | Unique cognitive style profile |
-| `Self::Anchor` | `lex-cognitive-anchor` | Stable cognitive anchor points |
-| `Self::Agency` | `lex-agency` | Sense of agency — authorship detection |
-| `Self::Personality` | `lex-personality` | Big Five OCEAN trait model |
-| `Self::Anosognosia` | `lex-anosognosia` | Unawareness of own deficits |
-| `Self::DefaultModeNetwork` | `lex-default-mode-network` | DMN analog — active during self-referential processing |
+| Sub-Module | Purpose |
+|---|---|
+| `Self::Identity` | Behavioral fingerprint (6 dimensions, entropy anomaly) + Entra ID binding |
+| `Self::Metacognition` | Second-order self-model — discovers loaded extensions, maps capabilities |
+| `Self::MetacognitiveMonitoring` | Continuous confidence calibration, feeling-of-knowing |
+| `Self::SelfModel` | Stable beliefs about capabilities, limitations, and values |
+| `Self::SelfTalk` | IFS-inspired inner dialogue — typed turns before action |
+| `Self::Reflection` | Post-tick meta-cognitive analysis — seven categories, EMA health scores |
+| `Self::NarrativeArc` | McAdams narrative arc — beats, tension, resolution |
+| `Self::NarrativeIdentity` | McAdams narrative identity — the agent's life story |
+| `Self::NarrativeSelf` | Minimal self vs. narrative self; autobiographical episode recording |
+| `Self::Architecture` | Meta-layer graph of cognitive subsystems — bottleneck detection |
+| `Self::Fingerprint` | Unique cognitive style profile |
+| `Self::Anchor` | Stable cognitive anchor points |
+| `Self::Agency` | Sense of agency — authorship detection |
+| `Self::Personality` | Big Five OCEAN trait model |
+| `Self::Anosognosia` | Unawareness of own deficits |
+| `Self::DefaultModeNetwork` | DMN analog — active during self-referential processing |
+| `Self::RelationshipArc` | Tracks relationship milestones and bond progression with other agents; stamps NarrativeIdentity episodes on milestone events |
 
 ## Actors
 
@@ -37,6 +38,10 @@ Domain consolidation gem for self-model, identity, metacognition, and self-aware
 - `Self::NarrativeIdentity::Actors::NarrativeDecay` — interval actor, decays narrative identity strength
 - `Self::SelfTalk::Actors::VolumeDecay` — runs every 300s, decays inner voice volumes
 
+## Dependencies
+
+Runtime: `legion-cache`, `legion-crypt`, `legion-data`, `legion-json`, `legion-logging`, `legion-settings`, `legion-transport`, `faraday ~> 2.0` (for Identity Microsoft Graph API calls).
+
 ## Installation
 
 ```ruby
@@ -47,8 +52,8 @@ gem 'lex-agentic-self'
 
 ```bash
 bundle install
-bundle exec rspec        # 1781 examples, 0 failures
-bundle exec rubocop      # 0 offenses
+bundle exec rspec
+bundle exec rubocop
 ```
 
 ## License

data/lex-agentic-self.gemspec

@@ -32,7 +32,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'legion-settings', '>= 1.3.14'
   spec.add_dependency 'legion-transport', '>= 1.3.9'
 
-  spec.add_development_dependency 'faraday', '~> 2.0'
+  spec.add_dependency 'faraday', '~> 2.0'
   spec.add_development_dependency 'rspec', '~> 3.13'
   spec.add_development_dependency 'rubocop'
   spec.add_development_dependency 'rubocop-legion'

data/lib/legion/extensions/agentic/self/identity/helpers/fingerprint.rb

@@ -18,6 +18,7 @@ module Legion
                 @model = Dimensions.new_identity_model
                 @observation_count = 0
                 @entropy_history = []
+                @local_previously_available = false
                 load_from_local
               end
 
@@ -87,7 +88,14 @@ module Legion
               end
 
               def save_to_local
-                return unless local_available?
+                unless local_available?
+                  if @local_previously_available
+                    Legion::Logging.warn 'lex-identity: local persistence unavailable after being available'
+                    return false
+                  end
+
+                  return nil
+                end
 
                 db = local_data_connection
 
@@ -161,7 +169,9 @@ module Legion
               private
 
               def local_available?
-                defined?(Legion::Data::Local) && respond_to?(:local_data_connected?) && local_data_connected?
+                available = defined?(Legion::Data::Local) && respond_to?(:local_data_connected?) && local_data_connected?
+                @local_previously_available = true if available
+                available
               end
             end
           end

data/lib/legion/extensions/agentic/self/identity/helpers/vault_secrets.rb

@@ -16,6 +16,10 @@ module Legion
             module VaultSecrets
               VAULT_PATH_PREFIX = 'secret/data/legion/workers'
 
+              def self.log
+                Legion::Logging
+              end
+
               def self.secret_path(worker_id)
                 "#{VAULT_PATH_PREFIX}/#{worker_id}/entra"
               end
@@ -68,7 +72,8 @@ module Legion
                 defined?(Legion::Crypt) &&
                   defined?(Legion::Settings) &&
                   Legion::Settings[:crypt][:vault][:connected] == true
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[identity:vault] vault_available? check failed: #{e.message}"
                 false
               end
             end

data/lib/legion/extensions/agentic/self/metacognition/helpers/self_model.rb

@@ -7,6 +7,10 @@ module Legion
         module Metacognition
           module Helpers
             module SelfModel
+              def self.log
+                Legion::Logging
+              end
+
               module_function
 
               def build(subsystem_states: {}, tick_results: {})
@@ -31,7 +35,8 @@ module Legion
                   ns = agentic.const_get(domain, false)
                   ns.is_a?(Module) && ns.const_defined?(ext_sym, false)
                 end
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[metacognition] extension_loaded? check failed: #{e.message}"
                 false
               end
 
@@ -39,7 +44,8 @@ module Legion
                 Constants::EXTENSION_CAPABILITIES.each_with_object({}) do |(ext_sym, _cat), acc|
                   acc[ext_sym] = { loaded: extension_loaded?(ext_sym) }
                 end
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[metacognition] discover_loaded_extensions failed: #{e.message}"
                 {}
               end
 

data/lib/legion/extensions/agentic/self/narrative_self/runners/narrative_self.rb

@@ -10,8 +10,8 @@ module Legion
               include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers, false) &&
                                                           Legion::Extensions::Helpers.const_defined?(:Lex, false)
 
-              def record_episode(description:, episode_type: :insight, domain: :general,
-                                 significance: nil, emotional_valence: 0.0, tags: [], **)
+              def record_narrative_self_episode(description:, episode_type: :insight, domain: :general,
+                                                significance: nil, emotional_valence: 0.0, tags: [], **)
                 episode = autobiography.record_episode(
                   description:       description,
                   episode_type:      episode_type,

data/lib/legion/extensions/agentic/self/reflection/helpers/llm_enhancer.rb

@@ -42,12 +42,12 @@ module Legion
                 false
               end
 
-              def enhance(prompt, phase: 'reflection', **)
+              def enhance(prompt, phase: 'reflection')
                 return nil unless available?
 
                 if pipeline_available?
                   response = Legion::LLM::Pipeline::GaiaCaller.chat(
-                    message: prompt, phase: phase, **
+                    message: prompt, phase: phase
                   )
                   response&.message&.dig(:content)
                 else

data/lib/legion/extensions/agentic/self/reflection/runners/reflection.rb

@@ -149,6 +149,8 @@ module Legion
                 update_emotion_score(tick_results)
                 update_memory_score(tick_results)
                 update_load_score(tick_results)
+                update_trust_score(tick_results)
+                update_mode_score(tick_results)
               end
 
               def update_prediction_score(tick_results)
@@ -190,6 +192,22 @@ module Legion
                 utilization = elapsed / budget
                 reflection_store.update_category_score(:cognitive_load, [1.0 - utilization, 0.0].max)
               end
+
+              def update_trust_score(tick_results)
+                social = tick_results[:social_cognition]
+                return unless social.is_a?(Hash) && social[:trust_drift].is_a?(Numeric)
+
+                reflection_store.update_category_score(:trust_drift, 1.0 - social[:trust_drift].abs)
+              end
+
+              def update_mode_score(tick_results)
+                state = tick_results[:tick_state]
+                return unless state.is_a?(Hash) && state[:mode_transitions].is_a?(Numeric)
+
+                transitions = state[:mode_transitions].to_f
+                threshold = Helpers::Constants::MODE_OSCILLATION_THRESHOLD.to_f
+                reflection_store.update_category_score(:mode_patterns, [1.0 - (transitions / threshold), 0.0].max)
+              end
             end
           end
         end

data/lib/legion/extensions/agentic/self/relationship_arc/runners/relationship_arc.rb

@@ -61,14 +61,15 @@ module Legion
                   tags:              ['partner', 'milestone', milestone.type.to_s]
                 )
               rescue StandardError => e
-                warn "[relationship_arc] narrative stamp failed: #{e.message}"
+                log.error "[relationship_arc] narrative stamp failed: #{e.message}"
               end
 
               def resolve_narrative_identity
                 return nil unless defined?(Legion::Extensions::Agentic::Self::NarrativeIdentity::Client)
 
                 @narrative_client ||= Legion::Extensions::Agentic::Self::NarrativeIdentity::Client.new
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[relationship_arc] resolve_narrative_identity failed: #{e.message}"
                 nil
               end
             end

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Self
-        VERSION = '0.1.12'
+        VERSION = '0.1.14'
       end
     end
   end

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

@@ -40,6 +40,43 @@ module Legion
         def self.transport_required?
           false
         end
+
+        def self.log
+          Legion::Logging
+        end
+
+        def self.personality_snapshot
+          client = Personality::Client.new
+          client.personality_profile
+        rescue StandardError => e
+          log.warn "[self] personality_snapshot failed: #{e.message}"
+          {}
+        end
+
+        def self.reflection_snapshot
+          client = Reflection::Client.new
+          result = client.recent_reflections(limit: 100)
+          result.is_a?(Hash) ? (result[:reflections] || []) : []
+        rescue StandardError => e
+          log.warn "[self] reflection_snapshot failed: #{e.message}"
+          []
+        end
+
+        def self.restore_personality(data)
+          return unless data.is_a?(Hash) && !data.empty?
+
+          log.info "[self] restore_personality: #{data.keys.join(', ')}"
+        rescue StandardError => e
+          log.error "[self] restore_personality failed: #{e.message}"
+        end
+
+        def self.restore_reflections(data)
+          return unless data.is_a?(Array) && !data.empty?
+
+          log.info "[self] restore_reflections: #{data.size} entries"
+        rescue StandardError => e
+          log.error "[self] restore_reflections failed: #{e.message}"
+        end
       end
     end
   end

data/spec/legion/extensions/agentic/self/identity/helpers/fingerprint_spec.rb

@@ -91,5 +91,13 @@ RSpec.describe Legion::Extensions::Agentic::Self::Identity::Helpers::Fingerprint
         expect(fp.save_to_local).to be_nil
       end
     end
+
+    it 'warns when local persistence was previously available but is no longer connected' do
+      fp.instance_variable_set(:@local_previously_available, true)
+      allow(fp).to receive(:local_data_connected?).and_return(false)
+
+      expect(Legion::Logging).to receive(:warn).with(/local persistence unavailable/)
+      expect(fp.save_to_local).to be false
+    end
   end
 end

data/spec/legion/extensions/agentic/self/narrative_self/client_spec.rb

@@ -8,7 +8,7 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeSelf::Client do
   end
 
   it 'includes all runner methods' do
-    expect(client).to respond_to(:record_episode)
+    expect(client).to respond_to(:record_narrative_self_episode)
     expect(client).to respond_to(:recent_episodes)
     expect(client).to respond_to(:significant_episodes)
     expect(client).to respond_to(:create_thread)
@@ -28,20 +28,20 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeSelf::Client do
       client.create_thread(theme: :mastery, domain: :technical)
 
       # Record experiences
-      client.record_episode(
+      client.record_narrative_self_episode(
         description:       'built first extension',
         episode_type:      :achievement,
         domain:            :technical,
         emotional_valence: 0.7,
         tags:              %i[building mastery]
       )
-      client.record_episode(
+      client.record_narrative_self_episode(
         description:  'learned about EMA',
         episode_type: :insight,
         domain:       :cognition,
         tags:         %i[learning math]
       )
-      client.record_episode(
+      client.record_narrative_self_episode(
         description:       'test failure taught me about edge cases',
         episode_type:      :discovery,
         domain:            :technical,

data/spec/legion/extensions/agentic/self/narrative_self/runners/narrative_self_spec.rb

@@ -3,9 +3,9 @@
 RSpec.describe Legion::Extensions::Agentic::Self::NarrativeSelf::Runners::NarrativeSelf do
   let(:client) { Legion::Extensions::Agentic::Self::NarrativeSelf::Client.new }
 
-  describe '#record_episode' do
+  describe '#record_narrative_self_episode' do
     it 'returns success with episode data' do
-      result = client.record_episode(description: 'completed first build', episode_type: :achievement)
+      result = client.record_narrative_self_episode(description: 'completed first build', episode_type: :achievement)
       expect(result[:success]).to be true
       expect(result[:episode][:description]).to eq('completed first build')
       expect(result[:episode][:episode_type]).to eq(:achievement)
@@ -14,7 +14,7 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeSelf::Runners::Narrat
 
   describe '#recent_episodes' do
     before do
-      3.times { |i| client.record_episode(description: "event #{i}") }
+      3.times { |i| client.record_narrative_self_episode(description: "event #{i}") }
     end
 
     it 'returns recent episodes' do
@@ -26,8 +26,8 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeSelf::Runners::Narrat
 
   describe '#significant_episodes' do
     before do
-      client.record_episode(description: 'major', significance: 0.9)
-      client.record_episode(description: 'minor', significance: 0.1)
+      client.record_narrative_self_episode(description: 'major', significance: 0.9)
+      client.record_narrative_self_episode(description: 'minor', significance: 0.1)
     end
 
     it 'filters by significance' do
@@ -39,8 +39,8 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeSelf::Runners::Narrat
 
   describe '#episodes_by_type' do
     before do
-      client.record_episode(description: 'win', episode_type: :achievement)
-      client.record_episode(description: 'learn', episode_type: :insight)
+      client.record_narrative_self_episode(description: 'win', episode_type: :achievement)
+      client.record_narrative_self_episode(description: 'learn', episode_type: :insight)
     end
 
     it 'filters by type' do
@@ -72,7 +72,7 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeSelf::Runners::Narrat
 
   describe '#timeline' do
     before do
-      3.times { |i| client.record_episode(description: "event #{i}") }
+      3.times { |i| client.record_narrative_self_episode(description: "event #{i}") }
     end
 
     it 'returns timeline entries' do
@@ -85,8 +85,8 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeSelf::Runners::Narrat
 
   describe '#self_summary' do
     before do
-      client.record_episode(description: 'a', episode_type: :achievement, domain: :tech)
-      client.record_episode(description: 'b', episode_type: :insight, domain: :personal)
+      client.record_narrative_self_episode(description: 'a', episode_type: :achievement, domain: :tech)
+      client.record_narrative_self_episode(description: 'b', episode_type: :insight, domain: :personal)
     end
 
     it 'returns comprehensive summary' do
@@ -100,7 +100,7 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeSelf::Runners::Narrat
 
   describe '#update_narrative_self' do
     it 'decays and reports counts' do
-      client.record_episode(description: 'test')
+      client.record_narrative_self_episode(description: 'test')
       result = client.update_narrative_self
       expect(result[:success]).to be true
       expect(result[:episode_count]).to eq(1)

data/spec/legion/extensions/agentic/self/reflection/helpers/llm_enhancer_spec.rb

@@ -75,6 +75,10 @@ RSpec.describe Legion::Extensions::Agentic::Self::Reflection::Helpers::LlmEnhanc
       allow(enhancer_mod).to receive(:available?).and_return(false)
       expect(enhancer_mod.enhance('hello')).to be_nil
     end
+
+    it 'rejects arbitrary extra kwargs instead of forwarding them to LLM' do
+      expect { enhancer_mod.enhance('hello', unexpected: true) }.to raise_error(ArgumentError)
+    end
   end
 
   describe '.available?' do

data/spec/legion/extensions/agentic/self/reflection/runners/reflection_spec.rb

@@ -46,6 +46,23 @@ RSpec.describe Legion::Extensions::Agentic::Self::Reflection::Runners::Reflectio
       expect(result[:health]).to be < 1.0
       expect(result[:category_scores][:prediction_calibration]).to eq(0.2)
     end
+
+    it 'updates trust_drift from social cognition results' do
+      client.reflect(tick_results: { social_cognition: { trust_drift: 0.4 } })
+
+      result = client.cognitive_health
+
+      expect(result[:category_scores][:trust_drift]).to eq(0.6)
+      expect(result[:health]).to be < 1.0
+    end
+
+    it 'updates mode_patterns from tick mode transition counts' do
+      client.reflect(tick_results: { tick_state: { mode_transitions: 5 } })
+
+      result = client.cognitive_health
+
+      expect(result[:category_scores][:mode_patterns]).to eq(0.0)
+    end
   end
 
   describe '#recent_reflections' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-self
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.1.14
 platform: ruby
 authors:
 - Esity
@@ -114,7 +114,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements: