lex-agentic-learning 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 14ead87d8b9aba4266580c17d9f8ece03e76d64f15375e8ef3b89f078aa1eb20
-  data.tar.gz: b9ca7ce1d976b330e1f66ed9bf8dc00cd2d4cedc7bd1adf45f161b356a5c87f9
+  metadata.gz: 1e3d434a965969263653baeab0cc752684ec0d7634b9b6eddf9caddc3de87883
+  data.tar.gz: 739255e9c779173dc965bfbe2bb3b4eb6f960f24cd10650e18eff611b99ab530
 SHA512:
-  metadata.gz: ff8f094be6c42376441676ae52450b091b42cfbd44ea39ff15631ce0a17cdc9b8e9a49e62b538c06813bf0712f6da9f902fd38305491384069dd196fee7220f5
-  data.tar.gz: 1e1d0819d02c30a65b1c59de7c4822592eb6047b64fda08ccbb60782c836a3a35a444fd4afbccd430ac86346ceb1cd9be47f21ba4f9cfea1aaedbc203eabad02
+  metadata.gz: d368996971593e6615df6c0495edfd70571cfabfebe7d5d58a47a5fc41fb285a7594d877345cde439e0e276e97379982f30675de1a38c5d87223f3cc2751bd42
+  data.tar.gz: 206ed5333af646c9261cf3647bdd521b6225a62092ed1f8e2aa863c41aa4ec1fdd2ba67aebda29ab9405ea8a7e4e7053b511118172e677ab5ec1b6f44285bcd1

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-03-18
+
+### Changed
+- Enforce SUBSTRATE_TYPES validation in FermentationEngine#create_substrate (returns nil for invalid type)
+- Enforce CATALYST_TYPES validation in FermentationEngine#catalyze (returns nil for invalid catalyst)
+
 ## [0.1.0] - 2026-03-18
 
 ### Added

data/README.md

@@ -1,13 +1,51 @@
 # lex-agentic-learning
 
-LEX agentic learning domain: adaptation, memory consolidation, skill acquisition
+Domain consolidation gem for learning, adaptation, and knowledge acquisition. Bundles 14 source extensions into one loadable unit under `Legion::Extensions::Agentic::Learning`.
 
-## Sub-modules
+## Overview
 
-*(populated as extensions are consolidated)*
+**Gem**: `lex-agentic-learning`
+**Version**: 0.1.1
+**Namespace**: `Legion::Extensions::Agentic::Learning`
+
+## Sub-Modules
+
+| Sub-Module | Source Gem | Purpose |
+|---|---|---|
+| `Learning::Curiosity` | `lex-curiosity` | Intrinsic curiosity — knowledge gap detection, wonder queue, salience decay |
+| `Learning::EpistemicCuriosity` | `lex-epistemic-curiosity` | Information-gap theory — specific vs. diversive curiosity |
+| `Learning::Hebbian` | `lex-hebbian-assembly` | Cell assembly formation — neurons that fire together wire together |
+| `Learning::Habit` | `lex-habit` | Habit formation — action sequence pattern recognition, maturity stages |
+| `Learning::LearningRate` | `lex-learning-rate` | Dynamic learning rate adaptation based on accuracy and stability |
+| `Learning::MetaLearning` | `lex-meta-learning` | Learning-to-learn — strategy selection per domain |
+| `Learning::PreferenceLearning` | `lex-preference-learning` | Learns stable preferences from choices over time |
+| `Learning::Procedural` | `lex-procedural-learning` | Skill acquisition through practice — automatization |
+| `Learning::Anchoring` | `lex-anchoring` | Anchoring bias in estimation |
+| `Learning::Plasticity` | `lex-cognitive-plasticity` | Neural-style plasticity — synaptic weight adjustment |
+| `Learning::Scaffolding` | `lex-cognitive-scaffolding` | Temporary learning assists that fade as competence grows |
+| `Learning::Fermentation` | `lex-cognitive-fermentation` | Time-based transformation of knowledge |
+| `Learning::Chrysalis` | `lex-cognitive-chrysalis` | Metamorphic state change — transformation through withdrawal |
+| `Learning::Catalyst` | `lex-cognitive-catalyst` | Accelerating cognitive transformation |
+
+## Actors
+
+- `Learning::Hebbian::Actors::Decay` — interval actor, decays Hebbian assembly connection strength
+- `Learning::PreferenceLearning::Actors::Decay` — interval actor, decays older preference observations
 
 ## Installation
 
 ```ruby
 gem 'lex-agentic-learning'
 ```
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec        # 1316 examples, 0 failures
+bundle exec rubocop      # 0 offenses
+```
+
+## License
+
+MIT

data/lib/legion/extensions/agentic/learning/fermentation/helpers/fermentation_engine.rb

@@ -15,6 +15,8 @@ module Legion
               end
 
               def create_substrate(substrate_type:, domain:, content: '', potency: nil, volatility: nil)
+                return nil unless SUBSTRATE_TYPES.include?(substrate_type.to_sym)
+
                 sub = Substrate.new(substrate_type: substrate_type, domain: domain, content: content,
                                     potency: potency, volatility: volatility)
                 @substrates[sub.id] = sub
@@ -33,6 +35,8 @@ module Legion
               end
 
               def catalyze(substrate_id:, catalyst_type:)
+                return nil unless CATALYST_TYPES.include?(catalyst_type.to_sym)
+
                 sub = @substrates[substrate_id]
                 return nil unless sub
 

data/lib/legion/extensions/agentic/learning/fermentation/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Learning
         module Fermentation
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Learning
-        VERSION = '0.1.0'
+        VERSION = '0.1.1'
       end
     end
   end

data/spec/legion/extensions/agentic/learning/fermentation/helpers/fermentation_engine_spec.rb

@@ -26,6 +26,18 @@ RSpec.describe Legion::Extensions::Agentic::Learning::Fermentation::Helpers::Fer
       engine.create_substrate(substrate_type: :raw_idea, domain: :emotional)
       expect(engine.fermentation_report[:total_batches]).to eq(2)
     end
+
+    it 'rejects invalid substrate_type' do
+      expect(engine.create_substrate(substrate_type: :telekinesis, domain: :cognitive)).to be_nil
+    end
+
+    it 'accepts all valid SUBSTRATE_TYPES' do
+      constants = Legion::Extensions::Agentic::Learning::Fermentation::Helpers::Constants
+      constants::SUBSTRATE_TYPES.each do |st|
+        result = engine.create_substrate(substrate_type: st, domain: :cognitive)
+        expect(result).not_to be_nil
+      end
+    end
   end
 
   describe '#ferment' do
@@ -50,6 +62,20 @@ RSpec.describe Legion::Extensions::Agentic::Learning::Fermentation::Helpers::Fer
     it 'returns nil for unknown substrate' do
       expect(engine.catalyze(substrate_id: 'x', catalyst_type: :analogy)).to be_nil
     end
+
+    it 'rejects invalid catalyst_type' do
+      sub = engine.create_substrate(substrate_type: :raw_idea, domain: :cognitive)
+      expect(engine.catalyze(substrate_id: sub.id, catalyst_type: :magic)).to be_nil
+    end
+
+    it 'accepts all valid CATALYST_TYPES' do
+      constants = Legion::Extensions::Agentic::Learning::Fermentation::Helpers::Constants
+      sub = engine.create_substrate(substrate_type: :raw_idea, domain: :cognitive, potency: 0.1)
+      constants::CATALYST_TYPES.each do |ct|
+        result = engine.catalyze(substrate_id: sub.id, catalyst_type: ct)
+        expect(result).not_to be_nil
+      end
+    end
   end
 
   describe '#ferment_all!' do

metadata

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