lex-agentic-imagination 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3af7d0d34493b7ea8b8d0fa72ac77bf3fbd4bad997c082f3f18a6ec061b1c9b8
-  data.tar.gz: c951351daa2a467697fcf162bced6dc603c8e5730230eed56ab1ee8e0e0a1bd9
+  metadata.gz: 6f5191865c4db37b876514b940c7ac084ff298416edb3e562c393847251fc9b4
+  data.tar.gz: 2ba1d6fda45304a1e71b5cdbccf0eaee008c99f109ea59eacf86f472330cf1f2
 SHA512:
-  metadata.gz: 02a8b50a581717b1a59aa587a3326739bc8736d70accce42ce142714f09f6b24d4d20604a3b735af26967568579ab3e96abb840a65f92cfb7ddc90ae701affff
-  data.tar.gz: ce6b5146992776ffdf6c8c7af4f3db4a19c368b10ed7eda0299ad8a1bc7c5e9282d4f2c18cd4492071c055026922cce2bad7b0ae7a9beee1a730335382e28118
+  metadata.gz: 4c498861d224fc8f74d6f867c9d581871fd7f7a8d3e8325a7c1d1a2ba66d90d8f2a2a9798d3c7baff15aeb12d84f53fe3b51f11d2bf2d862c8929188050ddeb2
+  data.tar.gz: 03b4a4cfa47bb540f80e624c7ce42bd2af6a383225dc89e9f2ce1d525ac55d82e204766d0ba00829164f074618cf89f0c41dad5886ce1cc03c6e950f04997f0b

data/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-## [Unreleased]
+## [0.1.5] - 2026-03-23
+
+### Added
+- Dream cycle knowledge promotion phase: promotes high-novelty association discoveries and resolved contradictions to Apollo knowledge graph
+- `phase_knowledge_promotion` ingests novel walks (novelty > 0.8) as associations and resolved contradictions as facts
+- Dream journal now includes Phase 7: Knowledge Promotion section with promotion count
+- Soft guard: phase is a no-op when lex-apollo or legion-data are not loaded
+
+## [0.1.4] - 2026-03-22
+
+### Changed
+- Add 7 legion-* runtime dependencies to gemspec (legion-cache, legion-crypt, legion-data, legion-json, legion-logging, legion-settings, legion-transport)
+- Update spec_helper to use real sub-gem helpers with Helpers::Lex including all 7 helper modules
 
 ## [0.1.3] - 2026-03-21
 

data/README.md

@@ -5,7 +5,7 @@ Domain consolidation gem for imagination, creativity, and offline simulation. Bu
 ## Overview
 
 **Gem**: `lex-agentic-imagination`
-**Version**: 0.1.2
+**Version**: 0.1.0
 **Namespace**: `Legion::Extensions::Agentic::Imagination`
 
 ## Sub-Modules
@@ -45,7 +45,7 @@ gem 'lex-agentic-imagination'
 
 ```bash
 bundle install
-bundle exec rspec        # 1855 examples, 0 failures
+bundle exec rspec        # 1885 examples, 0 failures
 bundle exec rubocop      # 0 offenses
 ```
 

data/lex-agentic-imagination.gemspec

@@ -24,6 +24,14 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ['lib']
 
+  spec.add_dependency 'legion-cache',     '>= 1.3.11'
+  spec.add_dependency 'legion-crypt',     '>= 1.4.9'
+  spec.add_dependency 'legion-data',      '>= 1.4.17'
+  spec.add_dependency 'legion-json',      '>= 1.2.1'
+  spec.add_dependency 'legion-logging',   '>= 1.3.2'
+  spec.add_dependency 'legion-settings',  '>= 1.3.14'
+  spec.add_dependency 'legion-transport', '>= 1.3.9'
+
   spec.add_development_dependency 'lex-emotion'
   spec.add_development_dependency 'lex-identity'
   spec.add_development_dependency 'lex-memory'

data/lib/legion/extensions/agentic/imagination/dream/helpers/constants.rb

@@ -22,6 +22,7 @@ module Legion
                 identity_entropy_check
                 agenda_formation
                 consolidation_commit
+                knowledge_promotion
                 dream_reflection
                 dream_narration
               ].freeze

data/lib/legion/extensions/agentic/imagination/dream/helpers/dream_journal.rb

@@ -38,6 +38,7 @@ module Legion
                 section_identity_entropy(lines, results, phase_data)
                 section_agenda(lines, results, phase_data)
                 section_consolidation(lines, results)
+                section_knowledge_promotion(lines, results)
                 section_summary(lines, results, phase_data)
                 lines.join("\n")
               end
@@ -160,6 +161,18 @@ module Legion
                 lines << ''
               end
 
+              def section_knowledge_promotion(lines, results)
+                promo = results[:knowledge_promotion] || {}
+                lines << '## Phase 7: Knowledge Promotion'
+                lines << ''
+                lines << if promo[:status] == :skipped
+                           "- Skipped: #{promo[:reason]}"
+                         else
+                           "- Insights promoted to Apollo: #{promo[:promoted]}"
+                         end
+                lines << ''
+              end
+
               def section_summary(lines, results, phase_data)
                 audit = results[:memory_audit] || {}
                 contra = results[:contradiction_resolution] || {}
@@ -179,6 +192,7 @@ module Legion
                 lines << "| Contradictions resolved | #{resolved} |"
                 lines << "| Agenda items formed | #{(results[:agenda_formation] || {})[:agenda_items]} |"
                 lines << "| Traces consolidated | #{(results[:consolidation_commit] || {})[:traces_written]} |"
+                lines << "| Knowledge promoted | #{(results[:knowledge_promotion] || {})[:promoted]} |"
               end
 
               def format_resolutions(lines, resolutions)
@@ -220,8 +234,9 @@ module Legion
 
               private_class_method :section_narrative, :section_memory_audit, :section_association_walk,
                                    :section_contradiction_resolution, :section_identity_entropy,
-                                   :section_agenda, :section_consolidation, :section_summary,
-                                   :format_resolutions, :extract_payload, :truncate, :summarize_content
+                                   :section_agenda, :section_consolidation, :section_knowledge_promotion,
+                                   :section_summary, :format_resolutions, :extract_payload,
+                                   :truncate, :summarize_content
             end
           end
         end

data/lib/legion/extensions/agentic/imagination/dream/runners/dream_cycle.rb

@@ -267,6 +267,19 @@ module Legion
                 { traces_written: traces.size, dream_store_cleared: true }
               end
 
+              def phase_knowledge_promotion(**)
+                return { status: :skipped, reason: :apollo_unavailable } unless apollo_available?
+
+                runner = Object.new.extend(Legion::Extensions::Apollo::Runners::Knowledge)
+                promoted = promote_novel_associations(runner) + promote_resolved_contradictions(runner)
+
+                Legion::Logging.debug "[dream] knowledge_promotion: promoted=#{promoted}"
+                { promoted: promoted }
+              rescue StandardError => e
+                Legion::Logging.warn "[dream] knowledge_promotion failed: #{e.message}"
+                { status: :error, error: e.message }
+              end
+
               def phase_dream_reflection(**)
                 return { status: :skipped, reason: :extension_not_loaded } unless reflection_available?
 
@@ -316,6 +329,67 @@ module Legion
                 false
               end
 
+              def promote_novel_associations(knowledge_runner)
+                walk_results = @phase_data[:walk_results] || []
+                store = memory.send(:default_store)
+                count = 0
+
+                walk_results.select { |w| w[:novelty_score] && w[:novelty_score] > 0.8 }.each do |walk|
+                  path_traces = walk[:path]&.filter_map { |id| store.get(id) }
+                  next if path_traces.size < 2
+
+                  payloads = path_traces.map { |t| summarize_trace_payload(t) }.compact
+                  next if payloads.empty?
+
+                  knowledge_runner.handle_ingest(
+                    content:         "Novel association discovered: #{payloads.join(' -> ')}",
+                    content_type:    :association,
+                    tags:            ['dream_cycle', 'association_walk', "novelty:#{walk[:novelty_score].round(2)}"],
+                    source_agent:    'dream-cycle',
+                    source_provider: 'legion',
+                    source_channel:  'dream_association_walk',
+                    context:         { path_length: walk[:path]&.size, novelty: walk[:novelty_score] }
+                  )
+                  count += 1
+                end
+                count
+              end
+
+              def promote_resolved_contradictions(knowledge_runner)
+                contradictions = @phase_data[:contradictions] || []
+                count = 0
+
+                contradictions.select { |c| c[:resolution] == :resolved && c[:reasoning] }.each do |contra|
+                  knowledge_runner.handle_ingest(
+                    content:         "Contradiction resolved: #{contra[:reasoning][0, 500]}",
+                    content_type:    :fact,
+                    tags:            ['dream_cycle', 'contradiction_resolved', "domain:#{contra[:domain]}"],
+                    source_agent:    'dream-cycle',
+                    source_provider: 'legion',
+                    source_channel:  'dream_contradiction',
+                    context:         { domain: contra[:domain], winner_id: contra[:winner_id] }
+                  )
+                  count += 1
+                end
+                count
+              end
+
+              def apollo_available?
+                defined?(Legion::Extensions::Apollo::Runners::Knowledge) &&
+                  defined?(Legion::Data::Model::ApolloEntry)
+              rescue StandardError
+                false
+              end
+
+              def summarize_trace_payload(trace)
+                payload = trace[:content_payload]
+                case payload
+                when String then payload[0, 120]
+                when Hash then payload.values.first(3).map { |v| v.to_s[0, 40] }.join(', ')
+                else payload.to_s[0, 120]
+                end
+              end
+
               def dream_store
                 @dream_store ||= Helpers::DreamStore.new
               end

data/lib/legion/extensions/agentic/imagination/dream/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Imagination
         module Dream
-          VERSION = '0.1.1'
+          VERSION = '0.1.2'
         end
       end
     end

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Imagination
-        VERSION = '0.1.3'
+        VERSION = '0.1.5'
       end
     end
   end

data/spec/legion/extensions/agentic/imagination/dream/runners/dream_cycle_spec.rb

@@ -15,12 +15,12 @@ RSpec.describe Legion::Extensions::Agentic::Imagination::Dream::Runners::DreamCy
   let(:trace_helper) { Legion::Extensions::Memory::Helpers::Trace }
 
   describe '#execute_dream_cycle' do
-    it 'returns a result hash with all eight phases' do
+    it 'returns a result hash with all nine phases' do
       result = client.execute_dream_cycle
       expect(result[:phases].keys).to contain_exactly(
         :memory_audit, :association_walk, :contradiction_resolution,
         :identity_entropy_check, :agenda_formation, :consolidation_commit,
-        :dream_reflection, :dream_narration
+        :knowledge_promotion, :dream_reflection, :dream_narration
       )
     end
 

data/spec/spec_helper.rb

@@ -1,16 +1,15 @@
 # frozen_string_literal: true
 
 require 'bundler/setup'
+require 'legion/logging'
+require 'legion/settings'
+require 'legion/cache/helper'
+require 'legion/crypt/helper'
+require 'legion/data/helper'
+require 'legion/json/helper'
+require 'legion/transport/helper'
 
 module Legion
-  module Logging
-    def self.debug(_msg); end
-    def self.info(_msg); end
-    def self.warn(_msg); end
-    def self.error(_msg); end
-    def self.fatal(_msg); end
-  end
-
   module Extensions
     module Core
       def self.extended(_base); end
@@ -18,24 +17,30 @@ module Legion
 
     module Helpers
       module Lex
-        def self.included(_base); end
+        include Legion::Logging::Helper
+        include Legion::Settings::Helper
+        include Legion::Cache::Helper
+        include Legion::Crypt::Helper
+        include Legion::Data::Helper
+        include Legion::JSON::Helper
+        include Legion::Transport::Helper
       end
     end
-  end
-end
 
-# rubocop:disable Lint/EmptyClass, Style/OneClassPerFile
-module Legion
-  module Extensions
     module Actors
-      class Every; end
-      class Once; end
+      class Every
+        include Helpers::Lex
+      end
+
+      class Once
+        include Helpers::Lex
+      end
     end
   end
 end
+
 $LOADED_FEATURES << 'legion/extensions/actors/every'
 $LOADED_FEATURES << 'legion/extensions/actors/once'
-# rubocop:enable Lint/EmptyClass, Style/OneClassPerFile
 
 require 'legion/extensions/memory'
 require 'legion/extensions/memory/client'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-imagination
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - Esity
@@ -9,6 +9,104 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: legion-cache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+- !ruby/object:Gem::Dependency
+  name: legion-crypt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+- !ruby/object:Gem::Dependency
+  name: legion-data
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+- !ruby/object:Gem::Dependency
+  name: legion-json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: legion-logging
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+- !ruby/object:Gem::Dependency
+  name: legion-settings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+- !ruby/object:Gem::Dependency
+  name: legion-transport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
 - !ruby/object:Gem::Dependency
   name: lex-emotion
   requirement: !ruby/object:Gem::Requirement