lex-agentic-memory 0.1.26 → 0.1.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e847dc63590787f98f33e475b6f2b02efb6a8628be4ac4a2ecd3d9c80a7fe559
-  data.tar.gz: e1428ea0a5d9b7c462ebe7d4e96a01fb137b7ab9e989a738d029cb8d529b6d70
+  metadata.gz: a4a726ce7792c2342e46df371973c90e78d11957ec56c76f4ab6c2f7c8c31b7a
+  data.tar.gz: 2fab727488f18d34881ff4805dcf5452b4a2fd3bde78a5924f5a638f4440b1c1
 SHA512:
-  metadata.gz: aa1728b3ddf58527e4ed616258d1632a13c6c5bb8f501044f9a7ee1d1961cfd303f54767aaabd5ebd3bdc03c3472604229405b4cee4b4c067df6c075373e2d67
-  data.tar.gz: db56e23e2c2effcd767e74d41eb3943431e2ff4054aa530d36800ab67fb6cbb88e2b80d84ebdab7180b2b5a3b0a107b5be7cc36725e7b018ea12413ed0f6d610
+  metadata.gz: ca13a314ea5c7eb0895bb98e36da27fd53992a3e66fd9b6e4da0e257a24e532fbd69be957a771d1f84295178b1e5b8fce20d18ec8a2289390474018714956e0d
+  data.tar.gz: ab7fe39c52cd26ac67567583f0f7c5ffa38cf16f8c0e8def6daeb3d3f93a22363dc0a8f130c8e777fa0545637ea234533a98a57f495cb1fd874b95767ed5e1de

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.1.28] - 2026-04-22
+### Fixed
+- Snapshot save/restore now logs warnings when Self/Affect module methods are unavailable instead of silently skipping
+- 26+ silent rescue blocks in trace persistence layer (postgres_store, store, hot_tier) now log errors via `log.error`
+### Changed
+- CLAUDE.md updated to document all 16 actors (was 5) and CommunicationPattern sub-module
+
+## [0.1.27] - 2026-04-17
+### Fixed
+- Add missing `Legion::Logging::Helper` include to `CacheStore` — resolves `NameError: undefined local variable or method 'log'` crash on startup when Memcached is available (#23)
+
 ## [0.1.26] - 2026-04-15
 ### Changed
 - Set `mcp_tools?`, `mcp_tools_deferred?`, and `transport_required?` to `false` — internal cognitive pipeline extension

data/README.md

@@ -1,43 +1,57 @@
 # lex-agentic-memory
 
-Domain consolidation gem for memory storage, retrieval, and consolidation. Bundles 18 source extensions into one loadable unit under `Legion::Extensions::Agentic::Memory`.
+Domain consolidation gem for memory storage, retrieval, and consolidation. Bundles 19 sub-modules into one loadable unit under `Legion::Extensions::Agentic::Memory`.
 
 ## Overview
 
 **Gem**: `lex-agentic-memory`
-**Version**: 0.1.26
+**Version**: 0.1.28
 **Namespace**: `Legion::Extensions::Agentic::Memory`
 
 ## Sub-Modules
 
-| Sub-Module | Source Gem | Purpose |
-|---|---|---|
-| `Memory::Trace` | `lex-memory` | Memory trace storage, power-law decay, Hebbian association, tiered retrieval |
-| `Memory::Episodic` | `lex-episodic-buffer` | Baddeley & Hitch episodic buffer — integrates working memory channels |
-| `Memory::Semantic` | `lex-semantic-memory` | Long-term conceptual knowledge — spreading activation |
-| `Memory::SemanticPriming` | `lex-semantic-priming` | Prior exposure boosts retrieval speed for related concepts |
-| `Memory::SemanticSatiation` | `lex-semantic-satiation` | Repeated activation reduces salience — cognitive desensitization |
-| `Memory::SourceMonitoring` | `lex-source-monitoring` | Attribution of memories to origin source |
-| `Memory::Transfer` | `lex-transfer-learning` | Knowledge transfer between domains |
-| `Memory::Archaeology` | `lex-cognitive-archaeology` | Excavates dormant or deeply buried traces |
-| `Memory::Paleontology` | `lex-cognitive-paleontology` | Excavating old knowledge layers |
-| `Memory::Palimpsest` | `lex-cognitive-palimpsest` | Layered memory overwriting — recovering original layers |
-| `Memory::Compression` | `lex-cognitive-compression` | Memory compression for storage efficiency |
-| `Memory::Hologram` | `lex-cognitive-hologram` | Distributed memory storage with holographic properties |
-| `Memory::Offloading` | `lex-cognitive-offloading` | Externalizing memory to reduce cognitive load |
-| `Memory::Nostalgia` | `lex-cognitive-nostalgia` | Nostalgic retrieval bias — past warmth enhancement |
-| `Memory::Echo` | `lex-cognitive-echo` | Echo/resonance of past experiences |
-| `Memory::EchoChamber` | `lex-cognitive-echo-chamber` | Self-reinforcing memory patterns |
-| `Memory::ImmuneMemory` | `lex-cognitive-immune-memory` | Immune-style memory for threat patterns |
-| `Memory::Reserve` | `lex-cognitive-reserve` | Cognitive reserve capacity |
+| Sub-Module | Purpose |
+|---|---|
+| `Memory::Trace` | Memory trace storage, power-law decay, Hebbian association, tiered retrieval |
+| `Memory::Episodic` | Baddeley & Hitch episodic buffer — integrates working memory channels |
+| `Memory::Semantic` | Long-term conceptual knowledge — spreading activation |
+| `Memory::SemanticPriming` | Prior exposure boosts retrieval speed for related concepts |
+| `Memory::SemanticSatiation` | Repeated activation reduces salience — cognitive desensitization |
+| `Memory::SourceMonitoring` | Attribution of memories to origin source |
+| `Memory::Transfer` | Knowledge transfer between domains |
+| `Memory::Archaeology` | Excavates dormant or deeply buried traces |
+| `Memory::Paleontology` | Excavating old knowledge layers |
+| `Memory::Palimpsest` | Layered memory overwriting — recovering original layers |
+| `Memory::Compression` | Memory compression for storage efficiency |
+| `Memory::Hologram` | Distributed memory storage with holographic properties |
+| `Memory::Offloading` | Externalizing memory to reduce cognitive load |
+| `Memory::Nostalgia` | Nostalgic retrieval bias — past warmth enhancement |
+| `Memory::Echo` | Echo/resonance of past experiences |
+| `Memory::EchoChamber` | Self-reinforcing memory patterns |
+| `Memory::ImmuneMemory` | Immune-style memory for threat patterns |
+| `Memory::Reserve` | Cognitive reserve capacity |
+| `Memory::CommunicationPattern` | Tracks temporal and channel communication patterns across traces; exposes `update_patterns`, `analyze_patterns`, `pattern_stats` |
 
 ## Actors
 
-- `Memory::Episodic::Actors::Decay` — interval actor, decays episodic buffer entries
-- `Memory::Semantic::Actors::Decay` — interval actor, decays semantic memory activation
-- `Memory::SourceMonitoring::Actors::Decay` — interval actor, decays source monitoring confidence
-- `Memory::Trace::Actors::Decay` — runs every 60s, executes `decay_cycle`
-- `Memory::Trace::Actors::TierMigration` — runs every 300s, migrates traces between tiers
+16 actors handle autonomous background processing (all interval-based):
+
+- `Memory::Archaeology::Actor::Decay` — every 120s
+- `Memory::Compression::Actor::Maintenance` — every 300s
+- `Memory::Echo::Actor::Decay` — every 60s
+- `Memory::EchoChamber::Actor::Decay` — every 60s
+- `Memory::Episodic::Actor::Decay` — every 15s
+- `Memory::ImmuneMemory::Actor::Decay` — every 60s
+- `Memory::Nostalgia::Actor::Maintenance` — every 120s
+- `Memory::Palimpsest::Actor::Decay` — every 60s
+- `Memory::Reserve::Actor::Maintenance` — every 60s
+- `Memory::Semantic::Actor::Decay` — every 300s
+- `Memory::SemanticPriming::Actor::Decay` — every 30s
+- `Memory::SemanticSatiation::Actor::Recovery` — every 60s
+- `Memory::SourceMonitoring::Actor::Decay` — every 60s
+- `Memory::Trace::Actor::Decay` — every 60s
+- `Memory::Trace::Actor::Quota` — every 300s
+- `Memory::Trace::Actor::TierMigration` — every 300s
 
 ## Installation
 
@@ -49,8 +63,8 @@ gem 'lex-agentic-memory'
 
 ```bash
 bundle install
-bundle exec rspec        # 1804 examples, 0 failures
-bundle exec rubocop      # 0 offenses
+bundle exec rspec
+bundle exec rubocop
 ```
 
 ## License

data/lib/legion/extensions/agentic/memory/trace/helpers/cache_store.rb

@@ -11,6 +11,8 @@ module Legion
             # An index key tracks all known trace IDs.
             # Keeps a local in-memory copy for fast reads; syncs to cache on flush.
             class CacheStore
+              include Legion::Logging::Helper if defined?(Legion::Logging::Helper)
+
               TRACE_PREFIX = 'legion:memory:trace:'
               INDEX_KEY    = 'legion:memory:trace_index'
               ASSOC_KEY    = 'legion:memory:associations'

data/lib/legion/extensions/agentic/memory/trace/helpers/hot_tier.rb

@@ -9,6 +9,10 @@ module Legion
             module HotTier
               HOT_TTL = 86_400 # 24 hours
 
+              def self.log
+                Legion::Logging
+              end
+
               module_function
 
               # Cache a trace in the Redis hot tier.
@@ -52,7 +56,8 @@ module Legion
               def available?
                 defined?(Legion::Cache::RedisHash) &&
                   Legion::Cache::RedisHash.redis_available?
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[trace_persistence] hot_tier available?: #{e.message}"
                 false
               end
 

data/lib/legion/extensions/agentic/memory/trace/helpers/postgres_store.rb

@@ -12,6 +12,8 @@ module Legion
             # All writes go directly to the database — no in-memory dirty tracking, no flush.
             # Scoped by tenant_id and agent_id so multiple agents can share the same DB tables safely.
             class PostgresStore
+              include Legion::Logging::Helper if defined?(Legion::Logging::Helper)
+
               TRACES_TABLE = :memory_traces
               ASSOCIATIONS_TABLE = :memory_associations
 
@@ -267,7 +269,8 @@ module Legion
                   Legion::Data.respond_to?(:connection) &&
                   Legion::Data.connection&.table_exists?(TRACES_TABLE) &&
                   Legion::Data.connection.table_exists?(ASSOCIATIONS_TABLE)
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[trace_persistence] db_ready?: #{e.message}"
                 false
               end
 
@@ -279,7 +282,8 @@ module Legion
 
               def resolve_agent_id
                 Legion::Settings.dig(:agent, :id) || 'default'
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[trace_persistence] resolve_agent_id: #{e.message}"
                 'default'
               end
 
@@ -392,7 +396,8 @@ module Legion
 
                 parsed = Legion::JSON.load(raw)
                 parsed.is_a?(Hash) ? parsed : raw
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[trace_persistence] parse_json_or_raw: #{e.message}"
                 raw
               end
 
@@ -401,7 +406,8 @@ module Legion
 
                 result = Legion::JSON.load(raw)
                 result.is_a?(Array) ? result : []
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[trace_persistence] parse_json_array: #{e.message}"
                 []
               end
 
@@ -412,7 +418,7 @@ module Legion
               end
 
               def log_warn(message)
-                Legion::Logging.warn "[memory:postgres_store] #{message}"
+                log.warn "[trace_persistence] #{message}"
               end
             end
           end

data/lib/legion/extensions/agentic/memory/trace/helpers/snapshot.rb

@@ -96,19 +96,31 @@ module Legion
                                             []
                                           end
 
+                  # NOTE: lex-agentic-self must implement these module-level methods for
+                  # personality and reflection state to be included in snapshots:
+                  #   Legion::Extensions::Agentic::Self.personality_snapshot => Hash
+                  #   Legion::Extensions::Agentic::Self.reflection_snapshot  => Array
+                  #   Legion::Extensions::Agentic::Self.restore_personality(state)
+                  #   Legion::Extensions::Agentic::Self.restore_reflections(history)
                   state[:personality_state] =
                     if defined?(Legion::Extensions::Agentic::Self) &&
                        Legion::Extensions::Agentic::Self.respond_to?(:personality_snapshot)
                       Legion::Extensions::Agentic::Self.personality_snapshot
                     else
+                      log.warn '[snapshot] Legion::Extensions::Agentic::Self.personality_snapshot unavailable — personality state skipped'
                       {}
                     end
 
+                  # NOTE: lex-agentic-affect must implement these module-level methods for
+                  # mood state to be included in snapshots:
+                  #   Legion::Extensions::Agentic::Affect.mood_snapshot => Hash
+                  #   Legion::Extensions::Agentic::Affect.restore_mood(state)
                   state[:mood_state] =
                     if defined?(Legion::Extensions::Agentic::Affect) &&
                        Legion::Extensions::Agentic::Affect.respond_to?(:mood_snapshot)
                       Legion::Extensions::Agentic::Affect.mood_snapshot
                     else
+                      log.warn '[snapshot] Legion::Extensions::Agentic::Affect.mood_snapshot unavailable — mood state skipped'
                       {}
                     end
 
@@ -124,6 +136,7 @@ module Legion
                        Legion::Extensions::Agentic::Self.respond_to?(:reflection_snapshot)
                       Legion::Extensions::Agentic::Self.reflection_snapshot
                     else
+                      log.warn '[snapshot] Legion::Extensions::Agentic::Self.reflection_snapshot unavailable — reflection history skipped'
                       []
                     end
 
@@ -151,16 +164,24 @@ module Legion
 
                 def restore_personality(personality_state)
                   return unless personality_state && !personality_state.empty?
-                  return unless defined?(Legion::Extensions::Agentic::Self) &&
-                                Legion::Extensions::Agentic::Self.respond_to?(:restore_personality)
+
+                  unless defined?(Legion::Extensions::Agentic::Self) &&
+                         Legion::Extensions::Agentic::Self.respond_to?(:restore_personality)
+                    log.warn '[snapshot] Legion::Extensions::Agentic::Self.restore_personality unavailable — personality state not restored'
+                    return
+                  end
 
                   Legion::Extensions::Agentic::Self.restore_personality(personality_state)
                 end
 
                 def restore_mood(mood_state)
                   return unless mood_state && !mood_state.empty?
-                  return unless defined?(Legion::Extensions::Agentic::Affect) &&
-                                Legion::Extensions::Agentic::Affect.respond_to?(:restore_mood)
+
+                  unless defined?(Legion::Extensions::Agentic::Affect) &&
+                         Legion::Extensions::Agentic::Affect.respond_to?(:restore_mood)
+                    log.warn '[snapshot] Legion::Extensions::Agentic::Affect.restore_mood unavailable — mood state not restored'
+                    return
+                  end
 
                   Legion::Extensions::Agentic::Affect.restore_mood(mood_state)
                 end
@@ -174,8 +195,12 @@ module Legion
 
                 def restore_reflections(reflection_history)
                   return unless reflection_history && !reflection_history.empty?
-                  return unless defined?(Legion::Extensions::Agentic::Self) &&
-                                Legion::Extensions::Agentic::Self.respond_to?(:restore_reflections)
+
+                  unless defined?(Legion::Extensions::Agentic::Self) &&
+                         Legion::Extensions::Agentic::Self.respond_to?(:restore_reflections)
+                    log.warn '[snapshot] Legion::Extensions::Agentic::Self.restore_reflections unavailable — reflection history not restored'
+                    return
+                  end
 
                   Legion::Extensions::Agentic::Self.restore_reflections(reflection_history)
                 end

data/lib/legion/extensions/agentic/memory/trace/helpers/store.rb

@@ -11,6 +11,8 @@ module Legion
             # In-memory store for development and testing.
             # Production deployments should use a PostgreSQL + Redis backed store.
             class Store
+              include Legion::Logging::Helper if defined?(Legion::Logging::Helper)
+
               attr_reader :traces, :associations
 
               def initialize(partition_id: nil)
@@ -246,7 +248,8 @@ module Legion
 
               def resolve_partition_id
                 Legion::Settings.dig(:agent, :id) || 'default'
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.error "[trace_persistence] resolve_partition_id: #{e.message}"
                 'default'
               end
 
@@ -284,13 +287,7 @@ module Legion
               end
 
               def deserialize_trace_from_db(row)
-                content_raw = row[:content]
-                content = begin
-                  parsed = ::JSON.parse(content_raw, symbolize_names: true)
-                  parsed.is_a?(Hash) ? parsed : content_raw
-                rescue StandardError => _e
-                  content_raw
-                end
+                content = parse_db_content(row[:content])
                 {
                   trace_id:                row[:trace_id],
                   trace_type:              row[:trace_type]&.to_sym,
@@ -299,17 +296,9 @@ module Legion
                   strength:                row[:strength],
                   peak_strength:           row[:peak_strength],
                   base_decay_rate:         row[:base_decay_rate],
-                  emotional_valence:       begin
-                    ::JSON.parse(row[:emotional_valence], symbolize_names: true)
-                  rescue StandardError => _e
-                    0.0
-                  end,
+                  emotional_valence:       parse_db_json(row[:emotional_valence], 'emotional_valence', symbolize: true) { 0.0 },
                   emotional_intensity:     row[:emotional_intensity],
-                  domain_tags:             begin
-                    ::JSON.parse(row[:domain_tags])
-                  rescue StandardError => _e
-                    []
-                  end,
+                  domain_tags:             parse_db_json(row[:domain_tags], 'domain_tags') { [] },
                   origin:                  row[:origin]&.to_sym,
                   created_at:              row[:created_at],
                   last_reinforced:         row[:last_reinforced],
@@ -318,22 +307,29 @@ module Legion
                   confidence:              row[:confidence],
                   storage_tier:            row[:storage_tier]&.to_sym,
                   partition_id:            row[:partition_id],
-                  associated_traces:       begin
-                    ::JSON.parse(row[:associated_traces])
-                  rescue StandardError => _e
-                    []
-                  end,
+                  associated_traces:       parse_db_json(row[:associated_traces], 'associated_traces') { [] },
                   parent_trace_id:         row[:parent_id],
-                  child_trace_ids:         begin
-                    ::JSON.parse(row[:child_ids])
-                  rescue StandardError => _e
-                    []
-                  end,
+                  child_trace_ids:         parse_db_json(row[:child_ids], 'child_ids') { [] },
                   unresolved:              row[:unresolved] || false,
                   consolidation_candidate: row[:consolidation_candidate] || false
                 }
               end
 
+              def parse_db_content(raw)
+                parsed = Legion::JSON.load(raw.to_s)
+                parsed.is_a?(Hash) ? parsed : raw
+              rescue StandardError => e
+                log.error "[trace_persistence] deserialize_trace_from_db content: #{e.message}"
+                raw
+              end
+
+              def parse_db_json(raw, field, **_opts, &default)
+                Legion::JSON.load(raw.to_s)
+              rescue StandardError => e
+                log.error "[trace_persistence] deserialize_trace_from_db #{field}: #{e.message}"
+                default&.call
+              end
+
               def link_traces(id_a, id_b)
                 trace_a = @traces[id_a]
                 trace_b = @traces[id_b]

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Memory
-        VERSION = '0.1.26'
+        VERSION = '0.1.28'
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-memory
 version: !ruby/object:Gem::Version
-  version: 0.1.26
+  version: 0.1.28
 platform: ruby
 authors:
 - Esity