lex-agentic-imagination 0.1.0 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b20e2342a0aa0fda9926d3c23410f918230481cb5add0095a098511e434756a
-  data.tar.gz: 0105f7cdf9636df8db506367dde12346db7aeb54699ef6e5c2e022c7d326e6ce
+  metadata.gz: 5d1c420bf77f0a7f266c585dc6b6cc245484f823115554f387960f33ba26bd97
+  data.tar.gz: d421248b241fb86b415b6c79b25fd980cee726fcd48a52d452d2f0aaf848e39c
 SHA512:
-  metadata.gz: 9ae7d8d4b5acbfcaadadbee2b7620434ab4f0c097fe4c91918b6fecf9f9bd0318a4f7b4989f9f67612d4ec3e5750ace3a0dff232bd1c9a6c5c4af4ff2032bcd3
-  data.tar.gz: 8ecba0c2c73bb641c8adb60aec34491ccff21a9b32d02d6c55a80c7ed4ec16a964ad5984c4f0a7930fcf7a0b9f5073bd1cf76f2345ddedccf7c5685c439d3d9d
+  metadata.gz: 6ceddfaf49c2bb89968722016637b1c3f07eb6da051dc828971679eec5e2a58f62a3fb5129d6c569e16bdc5d0eeb3d8d5d7981247322c4cd64fa823c66165fc5
+  data.tar.gz: 19939451cd833bbb94d7bda5e87072614e9b3453a41fd2375cde5fa3606cad0ee7708ca074eeaaf2b4e20eb7931a24ee7e0df41808f442ba496a0c164a2882cc

data/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 ## [Unreleased]
 
+## [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
+
+### 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/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/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.4'
       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

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.0
+  version: 0.1.4
 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