lex-agentic-imagination 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d1c420bf77f0a7f266c585dc6b6cc245484f823115554f387960f33ba26bd97
-  data.tar.gz: d421248b241fb86b415b6c79b25fd980cee726fcd48a52d452d2f0aaf848e39c
+  metadata.gz: 6f5191865c4db37b876514b940c7ac084ff298416edb3e562c393847251fc9b4
+  data.tar.gz: 2ba1d6fda45304a1e71b5cdbccf0eaee008c99f109ea59eacf86f472330cf1f2
 SHA512:
-  metadata.gz: 6ceddfaf49c2bb89968722016637b1c3f07eb6da051dc828971679eec5e2a58f62a3fb5129d6c569e16bdc5d0eeb3d8d5d7981247322c4cd64fa823c66165fc5
-  data.tar.gz: 19939451cd833bbb94d7bda5e87072614e9b3453a41fd2375cde5fa3606cad0ee7708ca074eeaaf2b4e20eb7931a24ee7e0df41808f442ba496a0c164a2882cc
+  metadata.gz: 4c498861d224fc8f74d6f867c9d581871fd7f7a8d3e8325a7c1d1a2ba66d90d8f2a2a9798d3c7baff15aeb12d84f53fe3b51f11d2bf2d862c8929188050ddeb2
+  data.tar.gz: 03b4a4cfa47bb540f80e624c7ce42bd2af6a383225dc89e9f2ce1d525ac55d82e204766d0ba00829164f074618cf89f0c41dad5886ce1cc03c6e950f04997f0b

data/CHANGELOG.md

@@ -1,6 +1,12 @@
 # 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
 

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/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.4'
+        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
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-imagination
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Esity