lex-synapse 0.4.6 → 0.4.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39062cc354ee7e7cf56da2062d54ee9a9730b76876aab24120cc341287a000ce
-  data.tar.gz: e9a27bd40eff6e3736e053482d77fcbb91962efc058d2c44219d3299daf1b7ee
+  metadata.gz: 84bfe76b9dd10227586c084c8005ad9824ee092ba47d9c8dcf71f2756de07b12
+  data.tar.gz: 2d7f842ce4b07913213051c3a3bdf80dbdbeca2bad3b4613d873856a22f41cf0
 SHA512:
-  metadata.gz: 9f6059e5c7c9f3b96032a1168c42270185ee2fee9484a78bd818ec3874019347bc80776d66400875fabc82e4af9acf5b2b9e5984a4503f63a9bd828c0a081f97
-  data.tar.gz: a0f56a6c852e39a737c4ccaf71e6e8421502df132093ce882e892c9706f7a3df74368bee0cf9d8df3990ffdea005b63caaa77dd9d303d3a5145fc42cb3280dfc
+  metadata.gz: 3c2a5c3ce4e8d4d4b86743234efc513a7b5540548331080b5a06db22ca6a018b1ea0abfdb4598496b29dae1ca67bc6553020ec880dc6cf66e3f58ebeee41f6be
+  data.tar.gz: 8853c5d3b0b8f814e49df2de326ad8d5070823b7210535d1d4a3d643b32a029aadc8add1bf9f879e99c11a4465eb7770522f473943095e2851cb04270ddc0911

data/.github/workflows/ci.yml

@@ -10,8 +10,8 @@ jobs:
   ci:
     uses: LegionIO/.github/.github/workflows/ci.yml@main
 
-  lint:
-    uses: LegionIO/.github/.github/workflows/lint-patterns.yml@main
+  excluded-files:
+    uses: LegionIO/.github/.github/workflows/excluded-files.yml@main
 
   security:
     uses: LegionIO/.github/.github/workflows/security-scan.yml@main
@@ -27,8 +27,8 @@ jobs:
     uses: LegionIO/.github/.github/workflows/stale.yml@main
 
   release:
-    needs: [ci, lint]
+    needs: [ci, excluded-files]
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     uses: LegionIO/.github/.github/workflows/release.yml@main
     secrets:
-      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/.rubocop.yml

@@ -1,53 +1,27 @@
-AllCops:
-  TargetRubyVersion: 3.4
-  NewCops: enable
-  SuggestExtensions: false
+inherit_gem:
+  rubocop-legion: config/lex.yml
 
-Layout/LineLength:
-  Max: 160
-Layout/SpaceAroundEqualsInParameterDefault:
-  EnforcedStyle: space
-Layout/HashAlignment:
-  EnforcedHashRocketStyle: table
-  EnforcedColonStyle: table
-
-Metrics/MethodLength:
-  Max: 50
-Metrics/ClassLength:
-  Max: 1500
-Metrics/ModuleLength:
-  Max: 1500
-Metrics/BlockLength:
-  Max: 40
-  Exclude:
-    - 'spec/**/*'
-Metrics/AbcSize:
-  Max: 60
-Metrics/CyclomaticComplexity:
-  Max: 15
-Metrics/PerceivedComplexity:
-  Max: 17
-Metrics/ParameterLists:
+# Actors define `def time` as instance method — cop looks for DSL call, false positive
+Legion/Extension/EveryActorRequiresTime:
   Enabled: false
 
-Style/Documentation:
+# Runner modules in this repo are designed for `include` into actors/client, not standalone
+Legion/Extension/RunnerIncludeHelpers:
   Enabled: false
-Style/SymbolArray:
-  Enabled: true
-Style/FrozenStringLiteralComment:
-  Enabled: true
-  EnforcedStyle: always
 
-Naming/FileName:
+# Private helper methods return non-Hash values by design; only public runner methods require Hash
+Legion/Extension/RunnerReturnHash:
   Enabled: false
-Naming/PredicateMethod:
-  Enabled: false
-Naming/PredicatePrefix:
+
+# migrations/ directory exists under data/; cop is checking the wrong path
+Legion/Extension/DataRequiredWithoutMigrations:
   Enabled: false
 
-Gemspec/DevelopmentDependencies:
+# Runner modules use Legion::JSON directly; helper mixin not included in standalone modules
+Legion/HelperMigration/DirectJson:
   Enabled: false
 
+# Spec helper defines empty stub classes for actor testing
 Lint/EmptyClass:
   Exclude:
     - 'spec/**/*'

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.4.8] - 2026-03-31
+
+### Added
+- Migration 007: add blast radius columns to synapses (`blast_radius`, `propagation_depth`, `downstream_count`, `blast_radius_updated_at`)
+- `Runners::BlastRadius`: BFS graph traversal computing propagation depth and downstream count per synapse; tier classification (LOW/MED/HIGH/CRITICAL) based on depth, downstream count, and throughput
+- `Actor::BlastRadius`: periodic interval actor (every 30 minutes) calling `Runners::BlastRadius#compute`
+- Blast radius multiplier wired into `Challenge#calculate_impact_score` (1.0x LOW, 1.5x MED, 2.0x HIGH, 3.0x CRITICAL)
+- HIGH and CRITICAL synapses require LLM challenge review regardless of impact threshold
+- `estimated_confidence_impact` on proposals now populated during challenge phase
+- `GaiaReport#gaia_summary` includes `blast_distribution` breakdown (LOW/MED/HIGH/CRITICAL/unknown counts)
+
+## [0.4.7] - 2026-03-30
+
+### Changed
+- update to rubocop-legion 0.1.7, resolve all offenses
+
 ## [0.4.6] - 2026-03-26
 
 ### Changed

data/Gemfile

@@ -9,6 +9,7 @@ group :test do
   gem 'rspec', '~> 3.13'
   gem 'rspec_junit_formatter'
   gem 'rubocop', '~> 1.75'
+  gem 'rubocop-legion', '~> 0.1'
   gem 'rubocop-rspec'
   gem 'sequel'
   gem 'simplecov'

data/lib/legion/extensions/synapse/actors/blast_radius.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative '../runners/blast_radius'
+
+module Legion
+  module Extensions
+    module Synapse
+      module Actor
+        class BlastRadius < Legion::Extensions::Actors::Every
+          include Legion::Extensions::Synapse::Runners::BlastRadius
+
+          def runner_class = self.class
+
+          def runner_function
+            'compute'
+          end
+
+          def time
+            1800
+          end
+
+          def use_runner?
+            false
+          end
+
+          def check_subtask?
+            false
+          end
+
+          def generate_task?
+            false
+          end
+
+          def action(**_opts)
+            compute
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/synapse/client.rb

@@ -11,6 +11,7 @@ require_relative 'runners/dream'
 require_relative 'runners/promote'
 require_relative 'runners/retrieve'
 require_relative 'runners/propose'
+require_relative 'runners/blast_radius'
 require_relative 'runners/challenge'
 require_relative 'data/models/synapse_proposal'
 require_relative 'helpers/proposals'
@@ -30,6 +31,7 @@ module Legion
         include Runners::Promote
         include Runners::Retrieve
         include Runners::Propose
+        include Runners::BlastRadius
         include Runners::Challenge
 
         attr_reader :conditioner_client, :transformer_client

data/lib/legion/extensions/synapse/data/migrations/007_add_blast_radius.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  up do
+    alter_table(:synapses) do
+      add_column :blast_radius,            String,   size: 10
+      add_column :propagation_depth,       Integer,  default: 0
+      add_column :downstream_count,        Integer,  default: 0
+      add_column :blast_radius_updated_at, DateTime
+    end
+  end
+
+  down do
+    alter_table(:synapses) do
+      drop_column :blast_radius
+      drop_column :propagation_depth
+      drop_column :downstream_count
+      drop_column :blast_radius_updated_at
+    end
+  end
+end

data/lib/legion/extensions/synapse/runners/blast_radius.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+require_relative '../data/models/synapse'
+require_relative '../data/models/synapse_proposal'
+
+module Legion
+  module Extensions
+    module Synapse
+      module Runners
+        module BlastRadius
+          TIER_CRITICAL = 'CRITICAL'
+          TIER_HIGH     = 'HIGH'
+          TIER_MED      = 'MED'
+          TIER_LOW      = 'LOW'
+
+          BLAST_MULTIPLIERS = {
+            TIER_LOW      => 1.0,
+            TIER_MED      => 1.5,
+            TIER_HIGH     => 2.0,
+            TIER_CRITICAL => 3.0
+          }.freeze
+
+          def compute(**_opts)
+            Data::Model.define_synapse_model
+            return { success: false, error: 'data unavailable' } unless data_available?
+
+            synapses = Data::Model::Synapse.where(status: 'active').all
+            return { success: true, updated: 0, skipped: 0 } if synapses.empty?
+
+            graph = build_graph(synapses)
+            updated = 0
+            skipped = 0
+
+            synapses.each do |synapse|
+              depth, count = bfs_reachable(synapse.id, graph)
+              tier = classify_tier(
+                depth:      depth,
+                downstream: count,
+                throughput: synapse.baseline_throughput.to_f
+              )
+
+              synapse.update(
+                propagation_depth:       depth,
+                downstream_count:        count,
+                blast_radius:            tier,
+                blast_radius_updated_at: Time.now
+              )
+              updated += 1
+            rescue StandardError => e
+              log.warn("blast_radius update failed for synapse #{synapse.id}: #{e.message}")
+              skipped += 1
+            end
+
+            { success: true, updated: updated, skipped: skipped }
+          end
+
+          def blast_tier(synapse_id:)
+            Data::Model.define_synapse_model
+            synapse = Data::Model::Synapse[synapse_id]
+            return nil unless synapse
+
+            synapse.blast_radius
+          end
+
+          def blast_multiplier_for(blast_radius_tier)
+            BLAST_MULTIPLIERS.fetch(blast_radius_tier.to_s.upcase, 1.0)
+          end
+
+          def requires_llm_review?(blast_radius_tier)
+            tier = blast_radius_tier.to_s.upcase
+            [TIER_HIGH, TIER_CRITICAL].include?(tier)
+          end
+
+          private
+
+          def data_available?
+            defined?(Legion::Data) && Legion::Settings.dig(:data, :connected)
+          end
+
+          def build_graph(synapses)
+            graph = Hash.new { |h, k| h[k] = [] }
+            synapses.each do |s|
+              next unless s.source_function_id && s.target_function_id
+
+              graph[s.source_function_id] << s.target_function_id
+            end
+            graph
+          end
+
+          def bfs_reachable(synapse_id, graph)
+            synapse = Data::Model::Synapse[synapse_id]
+            return [0, 0] unless synapse&.source_function_id && synapse.target_function_id
+
+            start = synapse.source_function_id
+            visited = {}
+            queue = [[start, 0]]
+            max_depth = 0
+            reachable = 0
+
+            until queue.empty?
+              node, depth = queue.shift
+              next if visited[node]
+
+              visited[node] = true
+
+              if depth.positive?
+                reachable += 1
+                max_depth = depth if depth > max_depth
+              end
+
+              graph[node].each do |neighbor|
+                queue << [neighbor, depth + 1] unless visited[neighbor]
+              end
+            end
+
+            [max_depth, reachable]
+          end
+
+          def classify_tier(depth:, downstream:, throughput:)
+            if depth > 5 || downstream > 25 || throughput > 500
+              TIER_CRITICAL
+            elsif depth > 3 || downstream > 10 || throughput > 100
+              TIER_HIGH
+            elsif depth > 1 || downstream > 3
+              TIER_MED
+            else
+              TIER_LOW
+            end
+          end
+
+          def log_warn(message)
+            log.warn(message)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/synapse/runners/challenge.rb

@@ -6,12 +6,15 @@ require_relative '../data/models/synapse'
 require_relative '../data/models/synapse_proposal'
 require_relative '../data/models/synapse_challenge'
 require_relative '../data/models/synapse_signal'
+require_relative 'blast_radius'
 
 module Legion
   module Extensions
     module Synapse
       module Runners
         module Challenge
+          include BlastRadius
+
           def pending_challenges
             Data::Model.define_synapse_proposal_model
             Data::Model::SynapseProposal.where(status: 'pending', challenge_state: nil)
@@ -36,11 +39,14 @@ module Legion
             proposal.update(challenge_state: 'challenging')
 
             impact = calculate_impact_score(proposal, synapse)
-            proposal.update(impact_score: impact)
+            confidence_impact = estimate_confidence_impact(proposal, synapse)
+            proposal.update(impact_score: impact, estimated_confidence_impact: confidence_impact)
 
             conflict_check(proposal)
 
-            llm_challenge(proposal, synapse, transformer_client) if Helpers::Challenge.above_impact_threshold?(impact) && transformer_client
+            needs_llm = Helpers::Challenge.above_impact_threshold?(impact) ||
+                        requires_llm_review?(synapse.blast_radius.to_s)
+            llm_challenge(proposal, synapse, transformer_client) if needs_llm && transformer_client
 
             aggregate_challenges(proposal)
           end
@@ -157,7 +163,7 @@ module Legion
               challenger_confidence: llm_confidence
             )
           rescue StandardError => e
-            Legion::Logging.warn("Challenge LLM call failed: #{e.message}") if defined?(Legion::Logging)
+            log.warn("Challenge LLM call failed: #{e.message}")
             Data::Model::SynapseChallenge.create(
               proposal_id: proposal.id, challenger_type: 'llm',
               verdict: 'abstain', reasoning: "LLM error: #{e.message}",
@@ -201,7 +207,14 @@ module Legion
             baseline = [synapse.respond_to?(:baseline_throughput) && synapse.baseline_throughput ? synapse.baseline_throughput : 1.0, 1.0].max
             throughput_factor = [recent_signals.to_f / baseline, 2.0].min
 
-            (base * synapse.confidence * throughput_factor).clamp(0.0, 1.0)
+            multiplier = blast_multiplier_for(synapse.blast_radius.to_s)
+            (base * synapse.confidence * throughput_factor * multiplier).clamp(0.0, 1.0)
+          end
+
+          def estimate_confidence_impact(proposal, synapse)
+            base = Helpers::Challenge::IMPACT_WEIGHTS.fetch(proposal.proposal_type, 0.5)
+            multiplier = blast_multiplier_for(synapse.blast_radius.to_s)
+            (base * multiplier * 0.1).clamp(0.0, 1.0)
           end
 
           def build_challenge_prompt(proposal, synapse)

data/lib/legion/extensions/synapse/runners/gaia_report.rb

@@ -29,7 +29,8 @@ module Legion
               elevated_pain_count: elevated_pain.size,
               avg_confidence:      avg_confidence(active),
               emergent_candidates: observing.size,
-              health_score:        compute_health_score(active, dampened, elevated_pain)
+              health_score:        compute_health_score(active, dampened, elevated_pain),
+              blast_distribution:  blast_distribution(synapses)
             }
           end
 
@@ -64,6 +65,23 @@ module Legion
             healthy = active.size - elevated_pain.size
             (healthy.to_f / total).round(4).clamp(0.0, 1.0)
           end
+
+          def blast_distribution(synapses)
+            tiers = %w[LOW MED HIGH CRITICAL]
+            dist = tiers.to_h { |t| [t, 0] }
+            dist['unknown'] = 0
+
+            synapses.each do |s|
+              tier = s.respond_to?(:blast_radius) && s.blast_radius ? s.blast_radius.upcase : 'unknown'
+              if dist.key?(tier)
+                dist[tier] += 1
+              else
+                dist['unknown'] += 1
+              end
+            end
+
+            dist
+          end
         end
       end
     end

data/lib/legion/extensions/synapse/runners/propose.rb

@@ -210,7 +210,7 @@ module Legion
             )
             { output: result[:success] ? Legion::JSON.dump(result[:result]) : nil }
           rescue StandardError => e
-            Legion::Logging.warn("Proposal LLM call failed: #{e.message}")
+            log.warn("Proposal LLM call failed: #{e.message}")
             { output: nil }
           end
 

data/lib/legion/extensions/synapse/runners/retrieve.rb

@@ -45,7 +45,7 @@ module Legion
             return nil unless content
 
             content.is_a?(String) ? Legion::JSON.load(content) : content
-          rescue StandardError
+          rescue StandardError => _e
             nil
           end
 

data/lib/legion/extensions/synapse/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Synapse
-      VERSION = '0.4.6'
+      VERSION = '0.4.8'
     end
   end
 end

data/lib/legion/extensions/synapse.rb

@@ -6,7 +6,7 @@ require_relative 'synapse/client'
 module Legion
   module Extensions
     module Synapse
-      extend Legion::Extensions::Core if Legion::Extensions.const_defined? :Core
+      extend Legion::Extensions::Core if Legion::Extensions.const_defined? :Core, false
 
       def self.remote_invocable?
         false

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-synapse
 version: !ruby/object:Gem::Version
-  version: 0.4.6
+  version: 0.4.8
 platform: ruby
 authors:
 - Esity
@@ -157,6 +157,7 @@ files:
 - Rakefile
 - lex-synapse.gemspec
 - lib/legion/extensions/synapse.rb
+- lib/legion/extensions/synapse/actors/blast_radius.rb
 - lib/legion/extensions/synapse/actors/challenge.rb
 - lib/legion/extensions/synapse/actors/crystallize.rb
 - lib/legion/extensions/synapse/actors/decay.rb
@@ -171,6 +172,7 @@ files:
 - lib/legion/extensions/synapse/data/migrations/004_create_synapse_proposals.rb
 - lib/legion/extensions/synapse/data/migrations/005_add_synapse_challenges.rb
 - lib/legion/extensions/synapse/data/migrations/006_add_slow_query_indexes.rb
+- lib/legion/extensions/synapse/data/migrations/007_add_blast_radius.rb
 - lib/legion/extensions/synapse/data/models/synapse.rb
 - lib/legion/extensions/synapse/data/models/synapse_challenge.rb
 - lib/legion/extensions/synapse/data/models/synapse_mutation.rb
@@ -181,6 +183,7 @@ files:
 - lib/legion/extensions/synapse/helpers/homeostasis.rb
 - lib/legion/extensions/synapse/helpers/proposals.rb
 - lib/legion/extensions/synapse/helpers/relationship_wrapper.rb
+- lib/legion/extensions/synapse/runners/blast_radius.rb
 - lib/legion/extensions/synapse/runners/challenge.rb
 - lib/legion/extensions/synapse/runners/crystallize.rb
 - lib/legion/extensions/synapse/runners/dream.rb