lex-agentic-imagination 0.1.0 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b20e2342a0aa0fda9926d3c23410f918230481cb5add0095a098511e434756a
-  data.tar.gz: 0105f7cdf9636df8db506367dde12346db7aeb54699ef6e5c2e022c7d326e6ce
+  metadata.gz: 3af7d0d34493b7ea8b8d0fa72ac77bf3fbd4bad997c082f3f18a6ec061b1c9b8
+  data.tar.gz: c951351daa2a467697fcf162bced6dc603c8e5730230eed56ab1ee8e0e0a1bd9
 SHA512:
-  metadata.gz: 9ae7d8d4b5acbfcaadadbee2b7620434ab4f0c097fe4c91918b6fecf9f9bd0318a4f7b4989f9f67612d4ec3e5750ace3a0dff232bd1c9a6c5c4af4ff2032bcd3
-  data.tar.gz: 8ecba0c2c73bb641c8adb60aec34491ccff21a9b32d02d6c55a80c7ed4ec16a964ad5984c4f0a7930fcf7a0b9f5073bd1cf76f2345ddedccf7c5685c439d3d9d
+  metadata.gz: 02a8b50a581717b1a59aa587a3326739bc8736d70accce42ce142714f09f6b24d4d20604a3b735af26967568579ab3e96abb840a65f92cfb7ddc90ae701affff
+  data.tar.gz: ce6b5146992776ffdf6c8c7af4f3db4a19c368b10ed7eda0299ad8a1bc7c5e9282d4f2c18cd4492071c055026922cce2bad7b0ae7a9beee1a730335382e28118

data/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## [Unreleased]
 
+## [0.1.3] - 2026-03-21
+
+### Changed
+- Spec suite expanded to 1897 examples (0 failures)
+
+## [0.1.2] - 2026-03-18
+
+### Changed
+- Enforce MODES enum validation in Imagery::Runners::Imagination#simulate (returns nil for invalid mode)
+- Enforce RISK_TOLERANCES enum validation in Imagery::Runners::Imagination#simulate (returns nil for invalid risk_tolerance)
+
+## [0.1.1] - 2026-03-18
+
+### Changed
+- Enforce AURORA_TYPES enum validation in AuroraEngine#detect_aurora (returns nil for invalid type)
+- Enforce DOMAINS enum validation in AuroraEngine#detect_aurora (returns nil for invalid domain)
+- Enforce SPECTRAL_CLASSES enum validation in SkyEngine#discover_star (returns nil for invalid spectral_class)
+
 ## [0.1.0] - 2026-03-18
 
 ### Added

data/README.md

@@ -1,13 +1,54 @@
 # lex-agentic-imagination
 
-LEX agentic imagination domain: mental simulation, creativity, prospection
+Domain consolidation gem for imagination, creativity, and offline simulation. Bundles 17 source extensions into one loadable unit under `Legion::Extensions::Agentic::Imagination`.
 
-## Sub-modules
+## Overview
 
-*(populated as extensions are consolidated)*
+**Gem**: `lex-agentic-imagination`
+**Version**: 0.1.2
+**Namespace**: `Legion::Extensions::Agentic::Imagination`
+
+## Sub-Modules
+
+| Sub-Module | Source Gem | Purpose |
+|---|---|---|
+| `Imagination::Dream` | `lex-dream` | Autonomous eight-phase dream cycle: consolidation, association, contradiction resolution, agenda |
+| `Imagination::Creativity` | `lex-creativity` | Creative ideation and novel combination generation |
+| `Imagination::Imagery` | `lex-imagination` | Offline simulation and mental imagery of non-present scenarios |
+| `Imagination::MentalSimulation` | `lex-mental-simulation` | Detailed mental simulation engine |
+| `Imagination::TimeTravel` | `lex-mental-time-travel` | Episodic future thinking and past recollection |
+| `Imagination::Prospection` | `lex-prospection` | Forward simulation for prospective thought |
+| `Imagination::EmbodiedSimulation` | `lex-embodied-simulation` | Barsalou grounded cognition — sensorimotor concept simulation |
+| `Imagination::Lucidity` | `lex-cognitive-lucidity` | Metacognitive clarity and lucid awareness |
+| `Imagination::Origami` | `lex-cognitive-origami` | Folding and refolding knowledge structures |
+| `Imagination::Alchemy` | `lex-cognitive-alchemy` | Transmutation of concepts into new forms |
+| `Imagination::Genesis` | `lex-cognitive-genesis` | Concept origination and creation |
+| `Imagination::Greenhouse` | `lex-cognitive-greenhouse` | Controlled growth environment for ideas |
+| `Imagination::Garden` | `lex-cognitive-garden` | Seed-to-plant lifecycle — nurturing and wilting of ideas |
+| `Imagination::Aurora` | `lex-cognitive-aurora` | Emergent illumination patterns |
+| `Imagination::Volcano` | `lex-cognitive-volcano` | Pressure buildup and creative eruption |
+| `Imagination::Liminal` | `lex-cognitive-liminal` | Threshold and transition states |
+| `Imagination::Constellation` | `lex-cognitive-constellation` | Pattern recognition across dispersed concepts |
+
+## Actors
+
+- `Imagination::Dream::Actors::DreamCycle` — runs every 300s, executes `execute_dream_cycle`
+- `Imagination::Prospection::Actors::Decay` — runs every 300s, executes `update_prospection`
 
 ## Installation
 
 ```ruby
 gem 'lex-agentic-imagination'
 ```
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec        # 1855 examples, 0 failures
+bundle exec rubocop      # 0 offenses
+```
+
+## License
+
+MIT

data/lib/legion/extensions/agentic/imagination/aurora/helpers/aurora_engine.rb

@@ -15,6 +15,9 @@ module Legion
               end
 
               def detect_aurora(type:, domain:, contributing_subsystems:, luminosity:, harmony_score:)
+                return nil unless AURORA_TYPES.include?(type.to_sym)
+                return nil unless DOMAINS.include?(domain.to_sym)
+
                 event = AuroraEvent.new(
                   aurora_type:             type,
                   domain:                  domain,

data/lib/legion/extensions/agentic/imagination/constellation/helpers/sky_engine.rb

@@ -14,6 +14,7 @@ module Legion
 
               def discover_star(name:, domain:, content:, magnitude: nil, spectral_class: nil)
                 raise ArgumentError, 'sky catalog full' if @stars.size >= Constants::MAX_STARS
+                return nil if !spectral_class.nil? && !Constants::SPECTRAL_CLASSES.include?(spectral_class.to_sym)
 
                 star = Star.new(name: name, domain: domain, content: content,
                                 magnitude: magnitude, spectral_class: spectral_class)

data/lib/legion/extensions/agentic/imagination/imagery/runners/imagination.rb

@@ -11,6 +11,9 @@ module Legion
                                                           Legion::Extensions::Helpers.const_defined?(:Lex)
 
               def simulate(actions:, context: {}, mode: :prospective, risk_tolerance: :moderate, **)
+                return nil unless Helpers::Constants::MODES.include?(mode.to_sym)
+                return nil unless Helpers::Constants::RISK_TOLERANCES.include?(risk_tolerance.to_sym)
+
                 scenarios = actions.first(Helpers::Constants::MAX_SCENARIOS).map do |action|
                   build_scenario(action, context)
                 end

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

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Imagination
         module Imagery
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         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.0'
+        VERSION = '0.1.3'
       end
     end
   end

data/spec/legion/extensions/agentic/imagination/aurora/helpers/aurora_engine_spec.rb

@@ -15,6 +15,26 @@ RSpec.describe Legion::Extensions::Agentic::Imagination::Aurora::Helpers::Aurora
   end
 
   describe '#detect_aurora' do
+    it 'returns nil for an invalid aurora type' do
+      expect(detect(type: :unknown_type)).to be_nil
+    end
+
+    it 'accepts all valid AURORA_TYPES' do
+      Legion::Extensions::Agentic::Imagination::Aurora::Helpers::Constants::AURORA_TYPES.each do |t|
+        expect(detect(type: t)).to be_a(Legion::Extensions::Agentic::Imagination::Aurora::Helpers::AuroraEvent)
+      end
+    end
+
+    it 'returns nil for an invalid domain' do
+      expect(detect(domain: :invalid_domain)).to be_nil
+    end
+
+    it 'accepts all valid DOMAINS' do
+      Legion::Extensions::Agentic::Imagination::Aurora::Helpers::Constants::DOMAINS.each do |d|
+        expect(detect(domain: d)).to be_a(Legion::Extensions::Agentic::Imagination::Aurora::Helpers::AuroraEvent)
+      end
+    end
+
     it 'returns an AuroraEvent' do
       event = detect
       expect(event).to be_a(Legion::Extensions::Agentic::Imagination::Aurora::Helpers::AuroraEvent)

data/spec/legion/extensions/agentic/imagination/constellation/helpers/sky_engine_spec.rb

@@ -8,6 +8,17 @@ RSpec.describe Legion::Extensions::Agentic::Imagination::Constellation::Helpers:
   end
 
   describe '#discover_star' do
+    it 'returns nil for an invalid spectral_class' do
+      expect(engine.discover_star(name: 'X', domain: :memory, content: 'test', spectral_class: :Z)).to be_nil
+    end
+
+    it 'accepts all valid SPECTRAL_CLASSES' do
+      Legion::Extensions::Agentic::Imagination::Constellation::Helpers::Constants::SPECTRAL_CLASSES.each do |sc|
+        s = engine.discover_star(name: sc.to_s, domain: :memory, content: 'test', spectral_class: sc)
+        expect(s).to be_a(Legion::Extensions::Agentic::Imagination::Constellation::Helpers::Star)
+      end
+    end
+
     it 'creates and stores a star' do
       s = engine.discover_star(name: 'Vega', domain: :memory, content: 'bright')
       expect(s).to be_a(Legion::Extensions::Agentic::Imagination::Constellation::Helpers::Star)

data/spec/legion/extensions/agentic/imagination/imagery/runners/imagination_spec.rb

@@ -37,6 +37,32 @@ RSpec.describe Legion::Extensions::Agentic::Imagination::Imagery::Runners::Imagi
       expect(conservative[:recommendation]).not_to be_nil
       expect(aggressive[:recommendation]).not_to be_nil
     end
+
+    it 'rejects invalid mode' do
+      result = client.simulate(actions: %w[deploy], mode: :nonexistent_value)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all MODES' do
+      described_class_constants = Legion::Extensions::Agentic::Imagination::Imagery::Helpers::Constants::MODES
+      described_class_constants.each do |val|
+        result = client.simulate(actions: %w[deploy], mode: val)
+        expect(result).not_to be_nil, "Expected #{val.inspect} to be accepted"
+      end
+    end
+
+    it 'rejects invalid risk_tolerance' do
+      result = client.simulate(actions: %w[deploy], risk_tolerance: :nonexistent_value)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all RISK_TOLERANCES' do
+      described_class_constants = Legion::Extensions::Agentic::Imagination::Imagery::Helpers::Constants::RISK_TOLERANCES
+      described_class_constants.each do |val|
+        result = client.simulate(actions: %w[deploy], risk_tolerance: val)
+        expect(result).not_to be_nil, "Expected #{val.inspect} to be accepted"
+      end
+    end
   end
 
   describe '#what_if' do

metadata

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