lex-agentic-homeostasis 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf2a2cd9fe0d18fe828d06eec1c26f0e106bc43141cad4857e78fa9bb54abbd1
-  data.tar.gz: d69e887bd9a9081e4e3dbf604f102c732a806a319c187f09f15856f2c879c04e
+  metadata.gz: 7b524356046e0a3d53d0dd87c57336b0dd6a46b8e9118c8eb09cf5c00da68e68
+  data.tar.gz: a19593d5527e336267943345a00d34e9a66dfc13e22bcd5ea2bf4aaf3c2b7c1e
 SHA512:
-  metadata.gz: 8f363868f9d48f7825ea8c6f754d5b1d48f6cdb21a4454bce405032215a1ef51c275f54ef15b4d8a8b55b7d6e4782e3df0e63312e006a7e683c0417d0fe26612
-  data.tar.gz: adb010bd024d1910a1bd2b83688ac1f1f3daee2f74492ef117fd334f1f473311d5629c0a3dc3f13a0a14843f2ad3471c942f278b94d0dbb1f93cfe94c6f9216c
+  metadata.gz: bd1611f91fa989cf28aa4a9e6d843120df9a6e08b282575ac2131f9a6497af461311ee50e76b304213e92801afea6fa72a308e2f197923445a0694167eca4c4b
+  data.tar.gz: 9aeb9734946ad799790aeeacba393b638bc14299cbb71ec239eeef1332707c1ad8bd29546e1b44a9fc62a86ebb5a7640fb20e14256cf4890476eea3f3f6a0b47

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-03-18
+
+### Changed
+- Enforce VARIABLE_CATEGORIES validation in HomeostasisEngine#create_variable (returns nil for invalid category)
+- Add :general to VARIABLE_CATEGORIES to support default category value
+- Enforce RHYTHM_TYPES validation in RhythmEngine#add_rhythm (returns nil for invalid rhythm_type)
+- Enforce COGNITIVE_DIMENSIONS validation in RhythmEngine#add_rhythm (returns nil for invalid dimension)
+
 ## [0.1.1] - 2026-03-18
 
 ### Changed

data/README.md

@@ -1,13 +1,61 @@
 # lex-agentic-homeostasis
 
-LEX agentic homeostasis domain: self-regulation, balance, resource management
+Domain consolidation gem for homeostasis, self-regulation, and internal state maintenance. Bundles 20 source extensions into one loadable unit under `Legion::Extensions::Agentic::Homeostasis`.
 
-## Sub-modules
+## Overview
 
-*(populated as extensions are consolidated)*
+**Gem**: `lex-agentic-homeostasis`
+**Version**: 0.1.2
+**Namespace**: `Legion::Extensions::Agentic::Homeostasis`
+
+## Sub-Modules
+
+| Sub-Module | Source Gem | Purpose |
+|---|---|---|
+| `Homeostasis::Homeostasis` | `lex-homeostasis` | Seven-setpoint negative feedback regulation, allostatic load |
+| `Homeostasis::FatigueModel` | `lex-cognitive-fatigue-model` | Cognitive resource depletion curves across session time |
+| `Homeostasis::Metabolism` | `lex-cognitive-metabolism` | Energy budget allocation and cognitive metabolic rate |
+| `Homeostasis::Rhythm` | `lex-cognitive-rhythm` | Circadian-like cognitive rhythm — sinusoidal oscillators, peak/low tide |
+| `Homeostasis::Tempo` | `lex-cognitive-tempo` | Processing speed modulation |
+| `Homeostasis::Tide` | `lex-cognitive-tide` | Tidal pool maintenance — periodic tide cycle |
+| `Homeostasis::Weathering` | `lex-cognitive-weathering` | Gradual wear on cognitive structures |
+| `Homeostasis::Weather` | `lex-cognitive-weather` | Unpredictable environmental cognitive conditions |
+| `Homeostasis::Pendulum` | `lex-cognitive-pendulum` | Oscillation between cognitive states |
+| `Homeostasis::Cocoon` | `lex-cognitive-cocoon` | Protective withdrawal and recovery state |
+| `Homeostasis::FossilFuel` | `lex-cognitive-fossil-fuel` | Stored energy from past experience |
+| `Homeostasis::Hourglass` | `lex-cognitive-hourglass` | Time-based resource depletion tracking |
+| `Homeostasis::Core` | `lex-homeostasis` | Core homeostasis regulation engine — seven setpoints, allostatic load, negative feedback regulator |
+| `Homeostasis::Neuromodulation` | `lex-neuromodulation` | Dopamine/serotonin/norepinephrine/acetylcholine analogs |
+| `Homeostasis::NeuralOscillation` | `lex-neural-oscillation` | Gamma/beta/alpha/theta/delta bands, cross-frequency coupling |
+| `Homeostasis::Temporal` | `lex-temporal` | Temporal reasoning — event ordering, duration estimation |
+| `Homeostasis::TemporalDiscounting` | `lex-temporal-discounting` | Hyperbolic discounting of future rewards |
+| `Homeostasis::Surplus` | `lex-cognitive-surplus` | Excess cognitive capacity allocation |
+| `Homeostasis::Tectonics` | `lex-cognitive-tectonics` | Deep structural cognitive shifts |
+| `Homeostasis::Furnace` | `lex-cognitive-furnace` | High-intensity cognitive processing — ore to alloy smelting metaphor |
+
+## Actors
+
+- `Homeostasis::NeuralOscillation::Actors::Tick` — interval actor, advances oscillation bands
+- `Homeostasis::Neuromodulation::Actors::Drift` — interval actor, applies neuromodulator drift
+- `Homeostasis::Surplus::Actors::Replenish` — interval actor, replenishes cognitive surplus
+- `Homeostasis::Tectonics::Actors::DriftTick` — interval actor, advances tectonic drift
+- `Homeostasis::Tempo::Actors::Adapt` — interval actor, adapts processing tempo
+- `Homeostasis::Tide::Actors::TideCycle` — runs every 60s, executes `tide_maintenance`
 
 ## Installation
 
 ```ruby
 gem 'lex-agentic-homeostasis'
 ```
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec        # 2270 examples, 0 failures
+bundle exec rubocop      # 0 offenses
+```
+
+## License
+
+MIT

data/lib/legion/extensions/agentic/homeostasis/homeostasis/helpers/constants.rb

@@ -32,7 +32,7 @@ module Legion
               }.freeze
 
               VARIABLE_CATEGORIES = %i[
-                arousal attention cognitive_load emotional_valence
+                general arousal attention cognitive_load emotional_valence
                 confidence curiosity fatigue motivation
                 social_engagement uncertainty
               ].freeze

data/lib/legion/extensions/agentic/homeostasis/homeostasis/helpers/homeostasis_engine.rb

@@ -16,6 +16,8 @@ module Legion
               def create_variable(name:, category: :general, setpoint: DEFAULT_SETPOINT,
                                   tolerance: DEFAULT_TOLERANCE, correction_rate: CORRECTION_RATE,
                                   initial_value: nil)
+                return nil unless VARIABLE_CATEGORIES.include?(category.to_sym)
+
                 prune_if_needed
                 variable = CognitiveVariable.new(
                   name:            name,

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

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Homeostasis
         module Homeostasis
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

data/lib/legion/extensions/agentic/homeostasis/rhythm/helpers/rhythm_engine.rb

@@ -16,6 +16,8 @@ module Legion
               end
 
               def add_rhythm(name:, rhythm_type:, dimension:, period: nil, amplitude: 0.5, phase_offset: 0.0)
+                return nil unless RHYTHM_TYPES.include?(rhythm_type.to_sym)
+                return nil unless COGNITIVE_DIMENSIONS.include?(dimension.to_sym)
                 return nil if @rhythms.size >= MAX_RHYTHMS
 
                 resolved_period = resolve_period(rhythm_type, period)

data/lib/legion/extensions/agentic/homeostasis/rhythm/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Homeostasis
         module Rhythm
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Homeostasis
-        VERSION = '0.1.1'
+        VERSION = '0.1.2'
       end
     end
   end

data/spec/legion/extensions/agentic/homeostasis/homeostasis/helpers/homeostasis_engine_spec.rb

@@ -14,6 +14,18 @@ RSpec.describe Legion::Extensions::Agentic::Homeostasis::Homeostasis::Helpers::H
       expect(var.category).to eq(:cognitive_load)
       expect(var.setpoint).to eq(0.3)
     end
+
+    it 'rejects invalid category' do
+      expect(engine.create_variable(name: 'bad', category: :nonexistent_category)).to be_nil
+    end
+
+    it 'accepts all VARIABLE_CATEGORIES' do
+      constants = Legion::Extensions::Agentic::Homeostasis::Homeostasis::Helpers::Constants::VARIABLE_CATEGORIES
+      constants.each do |cat|
+        var = engine.create_variable(name: "var_#{cat}", category: cat)
+        expect(var).not_to be_nil, "Expected category #{cat.inspect} to be accepted"
+      end
+    end
   end
 
   describe '#perturb' do

data/spec/legion/extensions/agentic/homeostasis/rhythm/helpers/rhythm_engine_spec.rb

@@ -56,6 +56,33 @@ RSpec.describe Legion::Extensions::Agentic::Homeostasis::Rhythm::Helpers::Rhythm
       r2 = add_alertness_rhythm
       expect(r1.id).not_to eq(r2.id)
     end
+
+    it 'rejects invalid rhythm_type' do
+      result = engine.add_rhythm(name: 'bad', rhythm_type: :nonexistent, dimension: :focus, amplitude: 0.5)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all RHYTHM_TYPES' do
+      constants = Legion::Extensions::Agentic::Homeostasis::Rhythm::Helpers::Constants::RHYTHM_TYPES
+      constants.each do |rt|
+        period = rt == :custom ? 1000 : nil
+        result = engine.add_rhythm(name: "r_#{rt}", rhythm_type: rt, dimension: :focus, period: period)
+        expect(result).not_to be_nil, "Expected rhythm_type #{rt.inspect} to be accepted"
+      end
+    end
+
+    it 'rejects invalid dimension' do
+      result = engine.add_rhythm(name: 'bad', rhythm_type: :ultradian, dimension: :nonexistent, amplitude: 0.5)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all COGNITIVE_DIMENSIONS' do
+      constants = Legion::Extensions::Agentic::Homeostasis::Rhythm::Helpers::Constants::COGNITIVE_DIMENSIONS
+      constants.each do |dim|
+        result = engine.add_rhythm(name: "r_#{dim}", rhythm_type: :ultradian, dimension: dim)
+        expect(result).not_to be_nil, "Expected dimension #{dim.inspect} to be accepted"
+      end
+    end
   end
 
   describe '#remove_rhythm' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-homeostasis
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Esity