lex-synapse 0.4.7 → 0.4.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b6960778e841594a06db2ac55e26f4618d66c5d0316f7e4e586d784586509171
-  data.tar.gz: cdf7db39426842d09a38241eb7ab3fb27e1329a6451d36de5bed80a669c96aa0
+  metadata.gz: 84bfe76b9dd10227586c084c8005ad9824ee092ba47d9c8dcf71f2756de07b12
+  data.tar.gz: 2d7f842ce4b07913213051c3a3bdf80dbdbeca2bad3b4613d873856a22f41cf0
 SHA512:
-  metadata.gz: 2ece1da6b1a9ad7e142927113f23a9f10a05aee0a8cebea0aaf49dcec41fde032f9e98435254d5c7fe7ddda2d9d859c86fec6087607c2895841c5bb0eb36dbc9
-  data.tar.gz: 48564fffc100fba87f7ab707e518b76322d556cea1dc2e11a3165b2a41d9e5c1572056bbe930810dc7f91a9c621f5994b3582781ac11469785509e5a4b266922
+  metadata.gz: 3c2a5c3ce4e8d4d4b86743234efc513a7b5540548331080b5a06db22ca6a018b1ea0abfdb4598496b29dae1ca67bc6553020ec880dc6cf66e3f58ebeee41f6be
+  data.tar.gz: 8853c5d3b0b8f814e49df2de326ad8d5070823b7210535d1d4a3d643b32a029aadc8add1bf9f879e99c11a4465eb7770522f473943095e2851cb04270ddc0911

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # 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

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
@@ -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/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-synapse
 version: !ruby/object:Gem::Version
-  version: 0.4.7
+  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