lex-agentic-executive 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63e7291af930919f6bba5e3491216cd3f08952dd0ee433bee20b644b7114006b
-  data.tar.gz: 64074c431b24fa82c65ad0c097b0eb1e88263ac17c3397647c72a93784937ee0
+  metadata.gz: 162085450c8aaeacfd84ced17da35c78b086d34d1ee9e4a0305a46784ac8d3ea
+  data.tar.gz: 8a8f9a4f5ffca47bbdcecd40fdc3b4616e3fc24bf0777458e0547a12317ad7df
 SHA512:
-  metadata.gz: ca2eae6c6c98e44e3252b7e24781ae041de08bc42b1a2e567c7300accdcaac3ec3718b8411487dd991cc36135bc52506c2e9485ae808ddabda76066f40b3467b
-  data.tar.gz: '0084babdf8779e23ad27e51c802101b103250aec6879e9da20d98f6874da850553df3ae72afdaefa53ddf2136ed807628a9dd1c44b3f625d2645e814aab4f7c1'
+  metadata.gz: f06abb9d450194b60de1e128952885bdb712ada8d8dd3cffa2a1744590c86ee91130b2c6ddb950cd7d04dfeaf5af943d781cd1061fcceddfdb9f5ef399fbc3d7
+  data.tar.gz: fb613003c03d2f7a571731433f2f1b08bd45645ea6ac22d70637ed2f03567487c34c0e0d3b1f3bfc7d8c465785567195d2446d08ae22c53ca82ce023a6dd3f4c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.7] - 2026-03-31
+
+### Added
+- Proactive outreach evaluation in Volition `form_intentions`
+- 4 trigger types: insight, check_in, milestone, curiosity
+- Attachment style gating (avoidant suppresses proactive)
+- Priority-based trigger selection
+
 ## [0.1.6] - 2026-03-26
 
 ### Changed

data/Gemfile

@@ -3,3 +3,5 @@
 source 'https://rubygems.org'
 
 gemspec
+
+gem 'rubocop-legion'

data/lex-agentic-executive.gemspec

@@ -33,6 +33,6 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'legion-transport', '>= 1.3.9'
 
   spec.add_development_dependency 'rspec', '~> 3.13'
-  spec.add_development_dependency 'rubocop', '~> 1.60'
-  spec.add_development_dependency 'rubocop-rspec', '~> 2.26'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-rspec'
 end

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Executive
-        VERSION = '0.1.6'
+        VERSION = '0.1.7'
       end
     end
   end

data/lib/legion/extensions/agentic/executive/volition/helpers/constants.rb

@@ -42,6 +42,15 @@ module Legion
 
               # Intention states
               STATES = %i[active suspended completed expired].freeze
+
+              # Proactive outreach triggers
+              PROACTIVE_TRIGGERS = %i[insight check_in milestone curiosity].freeze
+
+              # Priority ordering for trigger selection (lower = higher priority)
+              PRIORITY_ORDER = { critical: 0, urgent: 1, normal: 2, low: 3, ambient: 4 }.freeze
+
+              # Intent type for proactive outreach
+              PROACTIVE_INTENT_TYPE = :proactive_outreach
             end
           end
         end

data/lib/legion/extensions/agentic/executive/volition/runners/volition.rb

@@ -10,7 +10,7 @@ module Legion
               include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
                                                           Legion::Extensions::Helpers.const_defined?(:Lex)
 
-              def form_intentions(tick_results: {}, cognitive_state: {}, **)
+              def form_intentions(tick_results: {}, cognitive_state: {}, bond_state: {}, **)
                 drives = Helpers::DriveSynthesizer.synthesize(
                   tick_results:    tick_results,
                   cognitive_state: cognitive_state
@@ -26,17 +26,19 @@ module Legion
                 expired = intention_stack.decay_all
                 dominant = Helpers::DriveSynthesizer.dominant_drive(drives)
                 current = intention_stack.top
+                proactive = evaluate_proactive_outreach(tick_results, bond_state)
 
-                Legion::Logging.debug "[volition] drives=#{format_drives(drives)} pushed=#{pushed} expired=#{expired} " \
-                                      "active=#{intention_stack.active_count} top=#{current&.dig(:goal)}"
+                log.debug "[volition] drives=#{format_drives(drives)} pushed=#{pushed} expired=#{expired} " \
+                          "active=#{intention_stack.active_count} top=#{current&.dig(:goal)}"
 
                 {
-                  drives:            drives,
-                  dominant_drive:    dominant,
-                  new_intentions:    pushed,
-                  expired:           expired,
-                  active_intentions: intention_stack.active_count,
-                  current_intention: format_intention(current)
+                  drives:             drives,
+                  dominant_drive:     dominant,
+                  new_intentions:     pushed,
+                  expired:            expired,
+                  active_intentions:  intention_stack.active_count,
+                  current_intention:  format_intention(current),
+                  proactive_outreach: proactive
                 }
               end
 
@@ -55,19 +57,19 @@ module Legion
 
               def complete_intention(intention_id:, **)
                 result = intention_stack.complete(intention_id)
-                Legion::Logging.info "[volition] complete intention=#{intention_id} result=#{result}"
+                log.info "[volition] complete intention=#{intention_id} result=#{result}"
                 { status: result, intention_id: intention_id }
               end
 
               def suspend_intention(intention_id:, **)
                 result = intention_stack.suspend(intention_id)
-                Legion::Logging.info "[volition] suspend intention=#{intention_id} result=#{result}"
+                log.info "[volition] suspend intention=#{intention_id} result=#{result}"
                 { status: result, intention_id: intention_id }
               end
 
               def resume_intention(intention_id:, **)
                 result = intention_stack.resume(intention_id)
-                Legion::Logging.info "[volition] resume intention=#{intention_id} result=#{result}"
+                log.info "[volition] resume intention=#{intention_id} result=#{result}"
                 { status: result, intention_id: intention_id }
               end
 
@@ -95,8 +97,8 @@ module Legion
                 )
 
                 result = intention_stack.push(intention)
-                Legion::Logging.info "[volition] absorption intention formed: domains=#{domains.join(',')} " \
-                                     "neighbors=#{neighbors.size} salience=#{salience.round(2)} result=#{result}"
+                log.info "[volition] absorption intention formed: domains=#{domains.join(',')} " \
+                         "neighbors=#{neighbors.size} salience=#{salience.round(2)} result=#{result}"
 
                 {
                   success:      %i[pushed duplicate].include?(result),
@@ -152,6 +154,40 @@ module Legion
               def format_drives(drives)
                 drives.map { |k, v| "#{k}=#{v.round(2)}" }.join(' ')
               end
+
+              def evaluate_proactive_outreach(tick_results, bond_state)
+                return nil unless bond_state.is_a?(Hash) && bond_state[:partner_bond]
+
+                partner = bond_state[:partner_bond]
+                return nil if partner[:style] == :avoidant
+
+                triggers = collect_proactive_triggers(tick_results, partner)
+                return nil if triggers.empty?
+
+                best = triggers.min_by { |t| Helpers::Constants::PRIORITY_ORDER.fetch(t[:priority], 99) }
+                { type: Helpers::Constants::PROACTIVE_INTENT_TYPE, trigger: best, all_triggers: triggers }
+              end
+
+              def collect_proactive_triggers(tick_results, partner)
+                triggers = []
+
+                insight = tick_results.dig(:dream_reflection, :insight)
+                triggers << { reason: :insight, content: insight, priority: :low } if insight.is_a?(String) && insight.length > 50
+
+                triggers << { reason: :check_in, content: nil, priority: :normal } if partner[:absence_exceeds_pattern]
+
+                (partner[:milestones_today] || []).each do |ms|
+                  desc = ms.is_a?(Hash) ? (ms[:description] || ms['description']) : ms.to_s
+                  triggers << { reason: :milestone, content: desc, priority: :low }
+                end
+
+                agenda = tick_results.dig(:agenda_formation, :agenda) || []
+                agenda.select { |a| a[:domain] == :partner }.each do |item|
+                  triggers << { reason: :curiosity, content: item[:question], priority: :low }
+                end
+
+                triggers
+              end
             end
           end
         end

data/spec/legion/extensions/agentic/executive/volition/helpers/constants_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Legion::Extensions::Agentic::Executive::Volition::Helpers::Constants do
+  describe 'proactive constants' do
+    it 'defines PROACTIVE_TRIGGERS' do
+      expect(described_class::PROACTIVE_TRIGGERS).to include(:insight, :check_in, :milestone, :curiosity)
+    end
+
+    it 'defines PRIORITY_ORDER' do
+      expect(described_class::PRIORITY_ORDER).to be_a(Hash)
+      expect(described_class::PRIORITY_ORDER[:normal]).to be < described_class::PRIORITY_ORDER[:low]
+    end
+
+    it 'defines PROACTIVE_INTENT_TYPE' do
+      expect(described_class::PROACTIVE_INTENT_TYPE).to eq(:proactive_outreach)
+    end
+  end
+end

data/spec/legion/extensions/agentic/executive/volition/runners/volition_spec.rb

@@ -133,6 +133,107 @@ RSpec.describe Legion::Extensions::Agentic::Executive::Volition::Runners::Voliti
     end
   end
 
+  describe '#form_intentions with proactive evaluation' do
+    let(:bond_state) do
+      {
+        partner_bond: {
+          stage:            :established,
+          strength:         0.72,
+          style:            :secure,
+          health:           0.85,
+          milestones_today: [],
+          narrative:        nil
+        }
+      }
+    end
+
+    context 'when bond_state has partner bond' do
+      it 'includes proactive_outreach in result' do
+        result = client.form_intentions(tick_results: {}, bond_state: bond_state)
+        expect(result).to have_key(:proactive_outreach)
+      end
+
+      it 'returns nil proactive when no triggers fire' do
+        result = client.form_intentions(tick_results: {}, bond_state: bond_state)
+        expect(result[:proactive_outreach]).to be_nil
+      end
+    end
+
+    context 'when dream reflection has an insight' do
+      let(:tick_results) do
+        { dream_reflection: { insight: 'Discovered an interesting pattern in partner interaction frequency that suggests weekly review cycles.' } }
+      end
+
+      it 'generates insight trigger' do
+        result = client.form_intentions(tick_results: tick_results, bond_state: bond_state)
+        outreach = result[:proactive_outreach]
+        expect(outreach).not_to be_nil
+        expect(outreach[:trigger][:reason]).to eq(:insight)
+      end
+    end
+
+    context 'when partner absence exceeds pattern' do
+      let(:bond_state_absent) do
+        bond_state.merge(partner_bond: bond_state[:partner_bond].merge(absence_exceeds_pattern: true))
+      end
+
+      it 'generates check_in trigger' do
+        result = client.form_intentions(tick_results: {}, bond_state: bond_state_absent)
+        outreach = result[:proactive_outreach]
+        expect(outreach).not_to be_nil
+        expect(outreach[:trigger][:reason]).to eq(:check_in)
+      end
+    end
+
+    context 'when milestones exist today' do
+      let(:bond_state_milestone) do
+        ms = { description: 'Bond stage reached established', type: :stage_transition }
+        bond_state.merge(partner_bond: bond_state[:partner_bond].merge(milestones_today: [ms]))
+      end
+
+      it 'generates milestone trigger' do
+        result = client.form_intentions(tick_results: {}, bond_state: bond_state_milestone)
+        outreach = result[:proactive_outreach]
+        expect(outreach).not_to be_nil
+        expect(outreach[:trigger][:reason]).to eq(:milestone)
+      end
+    end
+
+    context 'when agenda has partner items' do
+      let(:tick_results) do
+        { agenda_formation: { agenda: [{ domain: :partner, question: 'How is the project going?' }] } }
+      end
+
+      it 'generates curiosity trigger' do
+        result = client.form_intentions(tick_results: tick_results, bond_state: bond_state)
+        outreach = result[:proactive_outreach]
+        expect(outreach).not_to be_nil
+        expect(outreach[:trigger][:reason]).to eq(:curiosity)
+      end
+    end
+
+    context 'when bond_state is empty' do
+      it 'returns nil proactive' do
+        result = client.form_intentions(tick_results: {}, bond_state: {})
+        expect(result[:proactive_outreach]).to be_nil
+      end
+    end
+
+    context 'when attachment style is avoidant' do
+      let(:bond_state_avoidant) do
+        bond_state.merge(partner_bond: bond_state[:partner_bond].merge(
+          style:                   :avoidant,
+          absence_exceeds_pattern: true
+        ))
+      end
+
+      it 'suppresses proactive outreach' do
+        result = client.form_intentions(tick_results: {}, bond_state: bond_state_avoidant)
+        expect(result[:proactive_outreach]).to be_nil
+      end
+    end
+  end
+
   describe '#form_absorption_intention' do
     it 'returns success false when no domains provided' do
       result = client.form_absorption_intention(domains_at_risk: [])

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-executive
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Esity
@@ -125,30 +125,30 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.60'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.60'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.26'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.26'
+        version: '0'
 description: 'LEX agentic executive domain: planning, working memory, cognitive control'
 email:
 - matthewdiverson@gmail.com
@@ -440,6 +440,7 @@ files:
 - spec/legion/extensions/agentic/executive/triage/helpers/triage_engine_spec.rb
 - spec/legion/extensions/agentic/executive/triage/runners_spec.rb
 - spec/legion/extensions/agentic/executive/volition/client_spec.rb
+- spec/legion/extensions/agentic/executive/volition/helpers/constants_spec.rb
 - spec/legion/extensions/agentic/executive/volition/helpers/drive_synthesizer_spec.rb
 - spec/legion/extensions/agentic/executive/volition/helpers/intention_spec.rb
 - spec/legion/extensions/agentic/executive/volition/helpers/intention_stack_spec.rb