lex-agentic-self 0.1.12 → 0.1.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ac6f03a82078dcd9825225bad2f7cb7a81b7ac517181beccd7b8e0e3a9fd4c5
-  data.tar.gz: '0190fc35f4bf31f56d85f7932dd94721b772bd1a8e6dd849f95f34c057d7890f'
+  metadata.gz: 86842222337e93a3e159eff411592f845792f5fde64fb32691feed47fff7ef7b
+  data.tar.gz: 440179ab3ad0a8dde91657cd0e2955a2dae16a2e50fdcdd99b7aff163fcda232
 SHA512:
-  metadata.gz: 5a8e94288b725ae83a1fbb6fc9317e830c9312535017fb772dc373a4e15c37e0b9d253dfed3f4f1ffd75001855247dc1818a6f96a5083ce0ffed45be084b0496
-  data.tar.gz: 2bc4e6f417b896828d6ec193e1710ad723f4ee969070184624b5537fc5816ae0793ba45f6b5cbe6ca444cc41a0cc76650a53ff994959629b1ba577a49eabfa47
+  metadata.gz: b180e99b145fc1f272cb29fafa7d09d28fa9b26aa3f5d56b11e6ab3263a31062234625f921ddd2eed47e891063aae2607298cdca21967b28f6072add6efb5184
+  data.tar.gz: 84e76ec6b1d8a781ce47f91c63218fefcc6a641068ec76bc0ec1e32aeb30f8da1869737b11c74a015a859b814f1bb69f3af3d2557483fd37970fdf3df24fd858

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [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/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/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.13'
       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/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)

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.13
 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: