lex-agentic-learning 0.1.7 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5e6816da7724d62662737aa4c9cb66b9b0baada3ffe3fdfb22a3e09083fe76d
-  data.tar.gz: cb0236bff38a3146abc0cc14922c588ac99733612e8e9ad75b629f6b53005eeb
+  metadata.gz: 8f2bd98de70d5e11f07c18043483a22d4325508c7e2601fd2d1c3a3bdb9726bd
+  data.tar.gz: e1f9d5d06972b5fe01b932d973050d701aa82663bca6ff76709769df476ea80b
 SHA512:
-  metadata.gz: b80674a59c3cd1980bfb3adc9358c11817fba0c6d15ca87538ff6c96486b9444666dc10755f535da85623006fa16999585999bda6c8bea788fd38a85e7bc8453
-  data.tar.gz: b9242b3f42079bb82949da94fba9081d1d3d803766c2b20eb9ec375f3d630c436be5355a58377bae523e44e8d22560dffb69fbbb553870717dbc827e5ca129b5
+  metadata.gz: d5858c88e16679558b7bf3d2433f3d88810a85f5a41cb7cf37991ccc22195569f65fffad058dbeb2aeaf359b89855dd3ac3330759da49e36c18c489afc08b713
+  data.tar.gz: 55abe2021cd74cbd3885d75a2ff321febe189d369e802ea910eced3d86ac9398adf807414880f006ab23b0a5b869f81a304093fdc10a05da8dedc6352136611a

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.1.9] - 2026-04-28
+### Fixed
+- Curiosity self-inquiry now uses the current `Legion::LLM.ask` API before falling back to legacy `Legion::LLM.complete`, preserving compatibility with the LLM routing uplift.
+
+## [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

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.7
+**Version**: 0.1.9
 **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,114 @@ 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 = extract_llm_text(result)
+                  return text if text && !text.empty?
+                end
+
+                # Direct LLM fallback for current legion-llm; complete is kept for older installs.
+                if defined?(Legion::LLM) && Legion::LLM.respond_to?(:ask)
+                  result = Legion::LLM.ask(message: prompt) # rubocop:disable Legion/HelperMigration/DirectLlm
+                  text = extract_llm_text(result)
+                  return text if text && !text.empty?
+                elsif defined?(Legion::LLM) && Legion::LLM.respond_to?(:complete)
+                  result = Legion::LLM.complete(prompt: prompt, max_tokens: 300)
+                  text = extract_llm_text(result)
+                  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 extract_llm_text(result)
+                return result.strip if result.is_a?(String)
+                return nil unless result.is_a?(Hash)
+
+                text = result[:response] || result[:content] || result[:text] || result[:completion]
+                text&.to_s&.strip
+              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 +208,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 +233,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.7'
+        VERSION = '0.1.9'
       end
     end
   end

data/spec/legion/extensions/agentic/learning/curiosity/runners/curiosity_spec.rb

@@ -156,4 +156,37 @@ RSpec.describe Legion::Extensions::Agentic::Learning::Curiosity::Runners::Curios
       expect(result[:pruned]).to eq(1)
     end
   end
+
+  describe '#query_llm_for_wonder' do
+    before do
+      allow(client).to receive(:respond_to?).and_call_original
+      allow(client).to receive(:respond_to?).with(:lex, true).and_return(false)
+    end
+
+    it 'uses Legion::LLM.ask response hashes for current legion-llm' do
+      llm = Module.new do
+        def self.ask(message:)
+          raise 'missing prompt' if message.to_s.empty?
+
+          { response: '  useful insight  ' }
+        end
+      end
+      stub_const('Legion::LLM', llm)
+
+      expect(client.send(:query_llm_for_wonder, 'why?', :curiosity)).to eq('useful insight')
+    end
+
+    it 'keeps legacy Legion::LLM.complete fallback for older installs' do
+      llm = Module.new do
+        def self.complete(prompt:, max_tokens:)
+          raise 'missing prompt' if prompt.to_s.empty? || max_tokens != 300
+
+          { content: 'legacy insight' }
+        end
+      end
+      stub_const('Legion::LLM', llm)
+
+      expect(client.send(:query_llm_for_wonder, 'why?', :curiosity)).to eq('legacy insight')
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-learning
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.9
 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