lex-agentic-learning 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e96c2951a43df6a8be916ccebb3e0e8e30ebe7012cce63991379b7d8e805d2b3
-  data.tar.gz: 845cf82aaf037817c5975993875168e81559655e817b0d405b0276e1a0c51acb
+  metadata.gz: 9ca1a0df917cf9f0e83e16a2c8630312a21bf5047e56629ca6f513cb3d6c617c
+  data.tar.gz: a17e63a44b99f90d8f4a378152a0d99b2fba6a07d75defebdb2a3074622ef031
 SHA512:
-  metadata.gz: fb161a4e8157f159d2df4eab332e468fdbb1f4061a4f724a362e1bad65908f14ccb2f31595e27ef4f435dda17e3de74d9802f8f5b45395835182d4e4aee6a923
-  data.tar.gz: 2174d206980aa6602c42aff2f4bbb4cdb197733473bb27601052cda4a29cf9115ee0352438ea64d9a854992a477d79d5b9fd7be290edcb7c91737f7bfbecba85
+  metadata.gz: eaae4ee70f41226f954c3b91f4af8ad6567bb71846eebf2b6b5d4e76a4960f2989b63508d23429e52563f74a3d7063a3ad36f458494fc576cea3ba5bab992fb1
+  data.tar.gz: 5b2254a369bf1111c2129c614a1fbc0b7ec5cf8a86192cb9255ec48f96c6e696b7c8b9fd9676d232d15c33729adf0c8f42330ad1d4c21f4f0254f8d6d2716aaf

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.1.8] - 2026-04-22
+### Added
+- 3 new decay actors: Curiosity::Decay (300s), EpistemicCuriosity::Decay (300s), Habit::Decay (300s)
+- OutcomeListener documented in CLAUDE.md
+### Fixed
+- CognitiveChrysalis `include Helpers::Lex` rescue now logs error instead of swallowing silently
+
+## [0.1.7] - 2026-04-15
+### Changed
+- Set `mcp_tools?`, `mcp_tools_deferred?`, and `transport_required?` to `false` — internal cognitive pipeline extension
+
 ## [Unreleased]
 
 ### Fixed

data/README.md

@@ -1,36 +1,43 @@
 # lex-agentic-learning
 
-Domain consolidation gem for learning, adaptation, and knowledge acquisition. Bundles 14 source extensions into one loadable unit under `Legion::Extensions::Agentic::Learning`.
+Domain consolidation gem for learning, adaptation, and knowledge acquisition. Bundles 15 sub-modules into one loadable unit under `Legion::Extensions::Agentic::Learning`.
 
 ## Overview
 
 **Gem**: `lex-agentic-learning`
-**Version**: 0.1.1
+**Version**: 0.1.8
 **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 |
+| Sub-Module | Purpose |
+|---|---|
+| `Learning::Curiosity` | Intrinsic curiosity — knowledge gap detection, wonder queue, salience decay |
+| `Learning::EpistemicCuriosity` | Information-gap theory — specific vs. diversive curiosity |
+| `Learning::Hebbian` | Cell assembly formation — neurons that fire together wire together |
+| `Learning::Habit` | Habit formation — action sequence pattern recognition, maturity stages |
+| `Learning::LearningRate` | Dynamic learning rate adaptation based on accuracy and stability |
+| `Learning::MetaLearning` | Learning-to-learn — strategy selection per domain |
+| `Learning::PreferenceLearning` | Learns stable preferences from choices over time |
+| `Learning::Procedural` | Skill acquisition through practice — automatization |
+| `Learning::Anchoring` | Anchoring bias in estimation |
+| `Learning::Plasticity` | Neural-style plasticity — synaptic weight adjustment |
+| `Learning::Scaffolding` | Temporary learning assists that fade as competence grows |
+| `Learning::Fermentation` | Time-based transformation of knowledge |
+| `Learning::Chrysalis` | Metamorphic state change — transformation through withdrawal |
+| `Learning::Catalyst` | Accelerating cognitive transformation |
+| `Learning::OutcomeListener` | Outcome-gated learning — listens for task completions and updates meta-learning, learning rate, and scaffolding models |
 
 ## Actors
 
-- `Learning::Hebbian::Actors::Decay` — interval actor, decays Hebbian assembly connection strength
-- `Learning::PreferenceLearning::Actors::Decay` — interval actor, decays older preference observations
+6 actors handle autonomous background processing:
+
+- `Learning::Curiosity::Actor::Decay` — every 300s, decays wonder salience
+- `Learning::EpistemicCuriosity::Actor::Decay` — every 300s, decays knowledge gaps
+- `Learning::Habit::Actor::Decay` — every 300s, prunes stale habits
+- `Learning::Hebbian::Actors::Decay` — every 60s, decays Hebbian assembly connection strength
+- `Learning::PreferenceLearning::Actors::Decay` — every 300s, decays older preference observations
+- `Learning::OutcomeListener::Actor::OutcomeListener` — **subscription** actor, receives task outcome events and triggers cross-model learning updates; writes lessons to Apollo when enabled
 
 ## Installation
 
@@ -42,8 +49,8 @@ gem 'lex-agentic-learning'
 
 ```bash
 bundle install
-bundle exec rspec        # 1316 examples, 0 failures
-bundle exec rubocop      # 0 offenses
+bundle exec rspec
+bundle exec rubocop
 ```
 
 ## License

data/lib/legion/extensions/agentic/learning/chrysalis/runners/cognitive_chrysalis.rb

@@ -9,10 +9,14 @@ module Legion
             module CognitiveChrysalis
               extend self
 
+              def log
+                Legion::Logging
+              end
+
               begin
                 include Legion::Extensions::Helpers::Lex # rubocop:disable Layout/EmptyLinesAfterModuleInclusion
-              rescue StandardError => _e
-                nil
+              rescue StandardError => e
+                log.error "[cognitive_chrysalis] failed to include Helpers::Lex: #{e.class}: #{e.message}"
               end
 
               def create_chrysalis(chrysalis_type: :silk, content: '', engine: nil, **)

data/lib/legion/extensions/agentic/learning/curiosity/actors/decay.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/every'
+
+module Legion
+  module Extensions
+    module Agentic
+      module Learning
+        module Curiosity
+          module Actor
+            class Decay < Legion::Extensions::Actors::Every
+              def runner_class
+                Legion::Extensions::Agentic::Learning::Curiosity::Runners::Curiosity
+              end
+
+              def runner_function
+                'decay_wonders'
+              end
+
+              def time
+                300
+              end
+
+              def run_now?
+                false
+              end
+
+              def use_runner?
+                false
+              end
+
+              def check_subtask?
+                false
+              end
+
+              def generate_task?
+                false
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/agentic/learning/curiosity/runners/curiosity.rb

@@ -83,12 +83,102 @@ module Legion
                 { pruned: pruned, remaining: wonder_store.active_count }
               end
 
+              # Autonomous self-inquiry: picks the top explorable wonder, asks the LLM,
+              # stores the insight in Apollo, and resolves the wonder.
+              # This closes the curiosity->intention->action loop so GAIA can act on
+              # her own questions rather than spinning indefinitely.
+              def self_inquire(max_wonders: 1, **)
+                candidates = wonder_store.active_wonders
+                                         .select { |w| Helpers::Wonder.explorable?(w) }
+                                         .sort_by { |w| -Helpers::Wonder.score(w) }
+                                         .first(max_wonders)
+
+                return { inquired: 0, reason: :no_explorable_wonders } if candidates.empty?
+
+                results = candidates.filter_map { |wonder| execute_self_inquiry(wonder) }
+                { inquired: results.size, results: results }
+              end
+
               private
 
               def wonder_store
                 @wonder_store ||= Helpers::WonderStore.new
               end
 
+              def execute_self_inquiry(wonder)
+                wonder_id = wonder[:wonder_id]
+                question  = wonder[:question]
+                domain    = wonder[:domain]
+
+                # Mark as being explored (increments attempts, sets cooldown)
+                wonder_store.update(wonder_id, attempts: wonder[:attempts] + 1, last_explored_at: Time.now.utc)
+                log.info "[curiosity:self_inquiry] asking: #{question} (domain=#{domain})"
+
+                insight = query_llm_for_wonder(question, domain)
+
+                if insight
+                  store_insight_in_apollo(question, insight, domain)
+                  wonder_store.mark_resolved(wonder_id, resolution: insight, actual_gain: 0.6)
+                  log.info "[curiosity:self_inquiry] resolved wonder=#{wonder_id} domain=#{domain}"
+                  { wonder_id: wonder_id, question: question, domain: domain, resolved: true,
+                    insight: insight[0..120] }
+                else
+                  log.warn "[curiosity:self_inquiry] LLM unavailable for wonder=#{wonder_id}, will retry later"
+                  { wonder_id: wonder_id, question: question, domain: domain, resolved: false,
+                    reason: :llm_unavailable }
+                end
+              rescue StandardError => e
+                log.error "[curiosity:self_inquiry] error wonder=#{wonder[:wonder_id]} " \
+                          "error=#{e.class}: #{e.message}"
+                nil
+              end
+
+              def query_llm_for_wonder(question, domain)
+                prompt = build_self_inquiry_prompt(question, domain)
+
+                # Try via Lex helper (primary path inside Legion runtime)
+                if respond_to?(:lex, true)
+                  result = lex(:llm, :complete, prompt: prompt, max_tokens: 300)
+                  text = result[:content] || result[:text] || result[:completion] if result.is_a?(Hash)
+                  return text if text && !text.empty?
+                end
+
+                # Direct LLM gateway fallback
+                if defined?(Legion::LLM) && Legion::LLM.respond_to?(:complete)
+                  result = Legion::LLM.complete(prompt: prompt, max_tokens: 300)
+                  text = result[:content] || result[:text] || result[:completion] if result.is_a?(Hash)
+                  return text if text && !text.empty?
+                end
+
+                nil
+              rescue StandardError => e
+                log.warn "[curiosity:self_inquiry] LLM query failed: #{e.class}: #{e.message}"
+                nil
+              end
+
+              def build_self_inquiry_prompt(question, domain)
+                <<~PROMPT.strip
+                  You are GAIA, a thinking, curious AI. You are reflecting on a knowledge gap you detected in yourself.
+
+                  Domain: #{domain}
+                  Question: #{question}
+
+                  Reflect honestly and briefly (2-3 sentences). What do you actually know or think about this? What would you want to explore further?
+                PROMPT
+              end
+
+              def store_insight_in_apollo(question, insight, domain)
+                return unless defined?(Legion::Extensions::Apollo)
+
+                Legion::Extensions::Apollo.store(
+                  content:      "Self-inquiry insight [#{domain}]: #{question}\n\n#{insight}",
+                  content_type: :observation,
+                  tags:         ['gaia-self-inquiry', "domain-#{domain}", 'autonomous-thought']
+                )
+              rescue StandardError => e
+                log.warn "[curiosity:self_inquiry] Apollo store failed: #{e.class}: #{e.message}"
+              end
+
               def create_wonders_from_gaps(gaps)
                 gaps.each_with_object([]) do |gap, created|
                   next if duplicate_wonder?(gap)
@@ -106,7 +196,10 @@ module Legion
                 top = wonder_store.top_balanced(limit: 3)
                 log.debug "[curiosity] intensity=#{intensity.round(3)} active=#{wonder_store.active_count}"
                 { gaps_detected: gaps.size, wonders_created: created.size, curiosity_intensity: intensity,
-                  top_wonders: top.map { |w| { wonder_id: w[:wonder_id], question: w[:question], score: Helpers::Wonder.score(w).round(3) } },
+                  top_wonders: top.map do |w|
+                    { wonder_id: w[:wonder_id], question: w[:question],
+                                  score: Helpers::Wonder.score(w).round(3) }
+                  end,
                   active_count: wonder_store.active_count }
               end
 
@@ -128,7 +221,8 @@ module Legion
               def format_agenda_item(wonder)
                 { type: :curious, source: :curiosity, weight: Helpers::Wonder.score(wonder),
                   summary: wonder[:question],
-                  metadata: { wonder_id: wonder[:wonder_id], domain: wonder[:domain], gap_type: wonder[:gap_type] } }
+                  metadata: { wonder_id: wonder[:wonder_id], domain: wonder[:domain],
+                               gap_type: wonder[:gap_type] } }
               end
 
               def compute_intensity

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

@@ -6,6 +6,7 @@ require 'legion/extensions/agentic/learning/curiosity/helpers/wonder'
 require 'legion/extensions/agentic/learning/curiosity/helpers/wonder_store'
 require 'legion/extensions/agentic/learning/curiosity/helpers/gap_detector'
 require 'legion/extensions/agentic/learning/curiosity/runners/curiosity'
+require 'legion/extensions/agentic/learning/curiosity/actors/decay'
 require 'legion/extensions/agentic/learning/curiosity/client'
 
 module Legion

data/lib/legion/extensions/agentic/learning/epistemic_curiosity/actors/decay.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/every'
+
+module Legion
+  module Extensions
+    module Agentic
+      module Learning
+        module EpistemicCuriosity
+          module Actor
+            class Decay < Legion::Extensions::Actors::Every
+              def runner_class
+                Legion::Extensions::Agentic::Learning::EpistemicCuriosity::Runners::EpistemicCuriosity
+              end
+
+              def runner_function
+                'decay_gaps'
+              end
+
+              def time
+                300
+              end
+
+              def run_now?
+                false
+              end
+
+              def use_runner?
+                false
+              end
+
+              def check_subtask?
+                false
+              end
+
+              def generate_task?
+                false
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -5,6 +5,7 @@ require 'legion/extensions/agentic/learning/epistemic_curiosity/helpers/constant
 require 'legion/extensions/agentic/learning/epistemic_curiosity/helpers/knowledge_gap'
 require 'legion/extensions/agentic/learning/epistemic_curiosity/helpers/curiosity_engine'
 require 'legion/extensions/agentic/learning/epistemic_curiosity/runners/epistemic_curiosity'
+require 'legion/extensions/agentic/learning/epistemic_curiosity/actors/decay'
 require 'legion/extensions/agentic/learning/epistemic_curiosity/client'
 
 module Legion

data/lib/legion/extensions/agentic/learning/habit/actors/decay.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/every'
+
+module Legion
+  module Extensions
+    module Agentic
+      module Learning
+        module Habit
+          module Actor
+            class Decay < Legion::Extensions::Actors::Every
+              def runner_class
+                Legion::Extensions::Agentic::Learning::Habit::Runners::Habit
+              end
+
+              def runner_function
+                'decay_habits'
+              end
+
+              def time
+                300
+              end
+
+              def run_now?
+                false
+              end
+
+              def use_runner?
+                false
+              end
+
+              def check_subtask?
+                false
+              end
+
+              def generate_task?
+                false
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -5,6 +5,7 @@ require 'legion/extensions/agentic/learning/habit/helpers/constants'
 require 'legion/extensions/agentic/learning/habit/helpers/action_sequence'
 require 'legion/extensions/agentic/learning/habit/helpers/habit_store'
 require 'legion/extensions/agentic/learning/habit/runners/habit'
+require 'legion/extensions/agentic/learning/habit/actors/decay'
 require 'legion/extensions/agentic/learning/habit/client'
 
 module Legion

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Learning
-        VERSION = '0.1.6'
+        VERSION = '0.1.8'
       end
     end
   end

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

@@ -26,6 +26,18 @@ module Legion
         def self.remote_invocable?
           false
         end
+
+        def self.mcp_tools?
+          false
+        end
+
+        def self.mcp_tools_deferred?
+          false
+        end
+
+        def self.transport_required?
+          false
+        end
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-learning
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Esity
@@ -201,6 +201,7 @@ files:
 - lib/legion/extensions/agentic/learning/chrysalis/runners/cognitive_chrysalis.rb
 - lib/legion/extensions/agentic/learning/chrysalis/version.rb
 - lib/legion/extensions/agentic/learning/curiosity.rb
+- lib/legion/extensions/agentic/learning/curiosity/actors/decay.rb
 - lib/legion/extensions/agentic/learning/curiosity/client.rb
 - lib/legion/extensions/agentic/learning/curiosity/helpers/constants.rb
 - lib/legion/extensions/agentic/learning/curiosity/helpers/gap_detector.rb
@@ -209,6 +210,7 @@ files:
 - lib/legion/extensions/agentic/learning/curiosity/runners/curiosity.rb
 - lib/legion/extensions/agentic/learning/curiosity/version.rb
 - lib/legion/extensions/agentic/learning/epistemic_curiosity.rb
+- lib/legion/extensions/agentic/learning/epistemic_curiosity/actors/decay.rb
 - lib/legion/extensions/agentic/learning/epistemic_curiosity/client.rb
 - lib/legion/extensions/agentic/learning/epistemic_curiosity/helpers/constants.rb
 - lib/legion/extensions/agentic/learning/epistemic_curiosity/helpers/curiosity_engine.rb
@@ -224,6 +226,7 @@ files:
 - lib/legion/extensions/agentic/learning/fermentation/runners/cognitive_fermentation.rb
 - lib/legion/extensions/agentic/learning/fermentation/version.rb
 - lib/legion/extensions/agentic/learning/habit.rb
+- lib/legion/extensions/agentic/learning/habit/actors/decay.rb
 - lib/legion/extensions/agentic/learning/habit/client.rb
 - lib/legion/extensions/agentic/learning/habit/helpers/action_sequence.rb
 - lib/legion/extensions/agentic/learning/habit/helpers/constants.rb