lex-agentic-self 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d78221dc914c624a359465f1b3eda8dd9e0cb6e89be19f1455e979b087ad4ae
-  data.tar.gz: 076c649303e81e8ab5396ef6bef33c1fe9bda3606df9c3ba533b249ab0d9b903
+  metadata.gz: 2d8b77eb5ec95e5f1ca51b1e58e7aa86999de7bda365e0771180dfdd06ff0d53
+  data.tar.gz: 7b0951301d43d15e5e7e198a7ab74a6a026afd0dc9c9b859d2b7a7c16efe4c1e
 SHA512:
-  metadata.gz: fa086ec76865a2b2f24057b110b88d1fc38f350ca540d6e2e2592ee64c1ced65eccd0735bdd4667a1f9b151adea39f3cfe56385cba4fb9bd0e712085951a067b
-  data.tar.gz: 40c44ecdd2afaa40586e85e8201d4ddf7fac5500b152316e070536f88484fb2dbfd1c4f982ead5fcda8b13ad98bb1c2ca162cc9f1debe15e369698bd8830a3e2
+  metadata.gz: 331f1b725ee8c2b93b654032318a0e3ab3bd371491d444d72914f81c0449df2d3ea4300b628c2d097af0275d7659d8138d44dddcece8901daf15ca34ad0f1bb5
+  data.tar.gz: c9687bd1e633d47a9abf4b4e6d3362950682047b5212c4ff32817264e3a45094673a48a33c702543409fa74ec6cf2a48e9203e23674ab34bad34b2a9083b9dcd

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-03-18
+
+### Changed
+- Enforce SUBSYSTEM_TYPES validation in Architecture::ArchitectureEngine#register_subsystem (raises ArgumentError)
+- Enforce CONNECTION_TYPES validation in Architecture::ArchitectureEngine#create_connection (raises ArgumentError)
+- Enforce EPISODE_TYPES validation in NarrativeIdentity::NarrativeEngine#add_episode (returns nil)
+- Enforce THEME_TYPES validation in NarrativeIdentity::NarrativeEngine#add_theme (returns nil)
+
 ## [0.1.0] - 2026-03-18
 
 ### Added

data/README.md

@@ -1,13 +1,56 @@
 # lex-agentic-self
 
-LEX agentic self domain: identity, metacognition, self-model
+Domain consolidation gem for self-model, identity, metacognition, and self-awareness. Bundles 16 source extensions into one loadable unit under `Legion::Extensions::Agentic::Self`.
 
-## Sub-modules
+## Overview
 
-*(populated as extensions are consolidated)*
+**Gem**: `lex-agentic-self`
+**Version**: 0.1.1
+**Namespace**: `Legion::Extensions::Agentic::Self`
+
+## Sub-Modules
+
+| Sub-Module | Source Gem | Purpose |
+|---|---|---|
+| `Self::Identity` | `lex-identity` | Behavioral fingerprint (6 dimensions, entropy anomaly) + Entra ID binding |
+| `Self::Metacognition` | `lex-metacognition` | Second-order self-model — discovers loaded extensions, maps capabilities |
+| `Self::MetacognitiveMonitoring` | `lex-metacognitive-monitoring` | Continuous confidence calibration, feeling-of-knowing |
+| `Self::SelfModel` | `lex-self-model` | Stable beliefs about capabilities, limitations, and values |
+| `Self::SelfTalk` | `lex-self-talk` | IFS-inspired inner dialogue — typed turns before action |
+| `Self::Reflection` | `lex-reflection` | Post-tick meta-cognitive analysis — seven categories, EMA health scores |
+| `Self::NarrativeArc` | `lex-cognitive-narrative-arc` | McAdams narrative arc — beats, tension, resolution |
+| `Self::NarrativeIdentity` | `lex-narrative-identity` | McAdams narrative identity — the agent's life story |
+| `Self::NarrativeSelf` | `lex-narrative-self` | Minimal self vs. narrative self |
+| `Self::Architecture` | `lex-cognitive-architecture` | Meta-layer graph of cognitive subsystems — bottleneck detection |
+| `Self::Fingerprint` | `lex-cognitive-fingerprint` | Unique cognitive style profile |
+| `Self::Anchor` | `lex-cognitive-anchor` | Stable cognitive anchor points |
+| `Self::Agency` | `lex-agency` | Sense of agency — authorship detection |
+| `Self::Personality` | `lex-personality` | Big Five OCEAN trait model |
+| `Self::Anosognosia` | `lex-anosognosia` | Unawareness of own deficits |
+| `Self::DefaultModeNetwork` | `lex-default-mode-network` | DMN analog — active during self-referential processing |
+
+## Actors
+
+- `Self::DefaultModeNetwork::Actors::Idle` — interval actor, activates DMN during idle periods
+- `Self::Identity::Actors::CredentialRefresh` — interval actor, refreshes Entra ID credentials
+- `Self::Identity::Actors::OrphanCheck` — runs every 14400s (4hr), checks for orphaned workers
+- `Self::NarrativeIdentity::Actors::NarrativeDecay` — interval actor, decays narrative identity strength
+- `Self::SelfTalk::Actors::VolumeDecay` — runs every 300s, decays inner voice volumes
 
 ## Installation
 
 ```ruby
 gem 'lex-agentic-self'
 ```
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec        # 1774 examples, 0 failures
+bundle exec rubocop      # 0 offenses
+```
+
+## License
+
+MIT

data/lib/legion/extensions/agentic/self/architecture/helpers/architecture_engine.rb

@@ -15,6 +15,10 @@ module Legion
               end
 
               def register_subsystem(name:, subsystem_type:, health: Constants::DEFAULT_HEALTH)
+                unless Constants::SUBSYSTEM_TYPES.include?(subsystem_type.to_sym)
+                  raise ArgumentError,
+                        "invalid subsystem_type: #{subsystem_type.inspect}, must be one of #{Constants::SUBSYSTEM_TYPES}"
+                end
                 raise ArgumentError, "subsystem '#{name}' already registered" if @subsystems.key?(name.to_sym)
                 raise ArgumentError, "max subsystems (#{Constants::MAX_SUBSYSTEMS}) reached" if @subsystems.size >= Constants::MAX_SUBSYSTEMS
 
@@ -24,6 +28,10 @@ module Legion
               end
 
               def create_connection(source_name:, target_name:, connection_type: :informational, weight: 0.5)
+                unless Constants::CONNECTION_TYPES.include?(connection_type.to_sym)
+                  raise ArgumentError,
+                        "invalid connection_type: #{connection_type.inspect}, must be one of #{Constants::CONNECTION_TYPES}"
+                end
                 raise ArgumentError, "max connections (#{Constants::MAX_CONNECTIONS}) reached" if @connections.size >= Constants::MAX_CONNECTIONS
 
                 source = find_subsystem!(source_name)

data/lib/legion/extensions/agentic/self/architecture/version.rb

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

data/lib/legion/extensions/agentic/self/narrative_identity/helpers/narrative_engine.rb

@@ -16,6 +16,8 @@ module Legion
               end
 
               def add_episode(content:, episode_type:, emotional_valence:, significance:, domain:)
+                return nil unless Constants::EPISODE_TYPES.include?(episode_type)
+
                 prune_episodes! if @episodes.size >= Constants::MAX_EPISODES
                 episode = Episode.new(
                   content:           content,
@@ -54,6 +56,8 @@ module Legion
               end
 
               def add_theme(name:, theme_type:)
+                return nil unless Constants::THEME_TYPES.include?(theme_type)
+
                 prune_themes! if @themes.size >= Constants::MAX_THEMES
                 theme = Theme.new(name: name, theme_type: theme_type)
                 @themes[theme.id] = theme

data/lib/legion/extensions/agentic/self/narrative_identity/version.rb

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

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Self
-        VERSION = '0.1.0'
+        VERSION = '0.1.1'
       end
     end
   end

data/spec/legion/extensions/agentic/self/architecture/helpers/architecture_engine_spec.rb

@@ -31,6 +31,18 @@ RSpec.describe Legion::Extensions::Agentic::Self::Architecture::Helpers::Archite
       sub = engine.register_subsystem(name: :custom, subsystem_type: :safety, health: 0.5)
       expect(sub.health).to eq(0.5)
     end
+
+    it 'raises on invalid subsystem_type' do
+      expect { engine.register_subsystem(name: :bad, subsystem_type: :telekinesis) }
+        .to raise_error(ArgumentError, /invalid subsystem_type/)
+    end
+
+    it 'accepts all valid SUBSYSTEM_TYPES' do
+      constants::SUBSYSTEM_TYPES.each do |stype|
+        result = engine.register_subsystem(name: :"sub_#{stype}", subsystem_type: stype)
+        expect(result).not_to be_nil
+      end
+    end
   end
 
   describe '#create_connection' do
@@ -61,6 +73,18 @@ RSpec.describe Legion::Extensions::Agentic::Self::Architecture::Helpers::Archite
       expect(conn.connection_type).to eq(:excitatory)
       expect(conn.weight).to eq(0.9)
     end
+
+    it 'raises on invalid connection_type' do
+      expect { engine.create_connection(source_name: :source, target_name: :target, connection_type: :telepathic) }
+        .to raise_error(ArgumentError, /invalid connection_type/)
+    end
+
+    it 'accepts all valid CONNECTION_TYPES' do
+      constants::CONNECTION_TYPES.each do |ctype|
+        conn = engine.create_connection(source_name: :source, target_name: :target, connection_type: ctype)
+        expect(conn).not_to be_nil
+      end
+    end
   end
 
   describe '#activate_subsystem' do

data/spec/legion/extensions/agentic/self/narrative_identity/helpers/narrative_engine_spec.rb

@@ -37,6 +37,18 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeIdentity::Helpers::Na
       expect(engine.episodes.size).to eq(max)
       expect(engine.episodes.key?(first_ep.id)).to be false
     end
+
+    it 'rejects invalid episode_type' do
+      expect(add_ep(type: :daydream)).to be_nil
+    end
+
+    it 'accepts all valid EPISODE_TYPES' do
+      constants = Legion::Extensions::Agentic::Self::NarrativeIdentity::Helpers::Constants
+      constants::EPISODE_TYPES.each do |etype|
+        result = add_ep(type: etype)
+        expect(result).not_to be_nil
+      end
+    end
   end
 
   describe '#create_chapter' do
@@ -107,6 +119,18 @@ RSpec.describe Legion::Extensions::Agentic::Self::NarrativeIdentity::Helpers::Na
         Legion::Extensions::Agentic::Self::NarrativeIdentity::Helpers::Theme
       )
     end
+
+    it 'rejects invalid theme_type' do
+      expect(engine.add_theme(name: 'bad', theme_type: :chaos)).to be_nil
+    end
+
+    it 'accepts all valid THEME_TYPES' do
+      constants = Legion::Extensions::Agentic::Self::NarrativeIdentity::Helpers::Constants
+      constants::THEME_TYPES.each do |ttype|
+        result = engine.add_theme(name: "theme_#{ttype}", theme_type: ttype)
+        expect(result).not_to be_nil
+      end
+    end
   end
 
   describe '#link_theme' do

metadata

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