Module: Legion::Extensions::MindGrowth::Runners::Evolver

Extended by:
Evolver
Includes:
Helpers::Lex
Included in:
Evolver
Defined in:
lib/legion/extensions/mind_growth/runners/evolver.rb

Constant Summary collapse

BOTTOM_PERCENTILE = 
0.05
SPECIATION_DRIFT_THRESHOLD = 
0.5
INELIGIBLE_STATUSES = 
%i[building testing].freeze
SUGGESTION_MAP = 
{
  low_invocations: 'improve wiring or broaden phase coverage',
  high_error_rate: 'add error handling and input validation',
  high_latency:    'optimize hot paths or add caching',
  low_impact:      'enrich output or add downstream connections'
}.freeze

Instance Method Summary collapse

Instance Method Details

#evolution_summary(extensions:) ⇒ Object 



67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
 
# File 'lib/legion/extensions/mind_growth/runners/evolver.rb', line 67

def evolution_summary(extensions:, **)
  exts = Array(extensions)

  improvement_candidates = select_for_improvement(extensions: exts, count: 5)[:candidates]

  prune_candidates = Helpers::FitnessEvaluator.prune_candidates(exts).map do |e|
    e[:name] || e[:extension_name]
  end

  speciation_candidates = exts.filter_map do |e|
    e[:name] || e[:extension_name] if (e[:drift_score] || 0.0) >= SPECIATION_DRIFT_THRESHOLD
  end

  fitnesses = exts.map { |e| Helpers::FitnessEvaluator.fitness(e) }

  distribution = if fitnesses.empty?
                   { min: 0.0, max: 0.0, mean: 0.0, median: 0.0 }
                 else
                   sorted = fitnesses.sort
                   mid    = sorted.size / 2
                   median = sorted.size.odd? ? sorted[mid] : ((sorted[mid - 1] + sorted[mid]) / 2.0).round(3)
                   { min:    sorted.first.round(3),
                     max:    sorted.last.round(3),
                     mean:   (fitnesses.sum / fitnesses.size.to_f).round(3),
                     median: median }
                 end

  { success:                true,
    improvement_candidates: improvement_candidates,
    prune_candidates:       prune_candidates,
    speciation_candidates:  speciation_candidates,
    fitness_distribution:   distribution }
end

#merge_extensions(extension_a:, extension_b:, merged_name: nil) ⇒ Object 



50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
 
# File 'lib/legion/extensions/mind_growth/runners/evolver.rb', line 50

def merge_extensions(extension_a:, extension_b:, merged_name: nil, **)
  name_a = extension_a[:name] || extension_a[:extension_name]
  name_b = extension_b[:name] || extension_b[:extension_name]
  cat_a  = (extension_a[:category] || :cognition).to_sym
  merged = merged_name || "lex-merged-#{name_a.to_s.delete_prefix('lex-')}-#{name_b.to_s.delete_prefix('lex-')}"
  desc   = "Merged extension combining capabilities of #{name_a} and #{name_b}"

  proposal = Runners::Proposer.propose_concept(
    name:        merged,
    category:    cat_a,
    description: desc,
    enrich:      false
  )

  { success: true, merged_proposal: proposal, sources: [name_a, name_b] }
end

#propose_improvement(extension:) ⇒ Object 



28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/legion/extensions/mind_growth/runners/evolver.rb', line 28

def propose_improvement(extension:, **)
  name     = extension[:name] || extension[:extension_name]
  fitness  = Helpers::FitnessEvaluator.fitness(extension)

  weaknesses = identify_weaknesses(extension)
  suggestions = generate_suggestions(weaknesses)

  if defined?(Legion::LLM) && Legion::LLM.respond_to?(:started?) && Legion::LLM.started?
    suggestions = llm_suggestions(name, fitness, weaknesses) || suggestions
  end

  { success: true, extension_name: name, fitness: fitness,
    weaknesses: weaknesses, suggestions: suggestions }
end

#replace_extension(old_name:, new_proposal_id:) ⇒ Object 



43
44
45
46
47
48
 
# File 'lib/legion/extensions/mind_growth/runners/evolver.rb', line 43

def replace_extension(old_name:, new_proposal_id:, **)
  status_store[old_name] = :pruned
  replacement_map[old_name] = new_proposal_id

  { success: true, replaced: old_name, replacement_proposal_id: new_proposal_id }
end

#select_for_improvement(extensions:, count: 3) ⇒ Object 



17
18
19
20
21
22
23
24
25
26
 
# File 'lib/legion/extensions/mind_growth/runners/evolver.rb', line 17

def select_for_improvement(extensions:, count: 3, **)
  exts = Array(extensions)
  return { success: true, candidates: [], count: 0, total_evaluated: 0 } if exts.empty?

  eligible = exts.reject { |e| INELIGIBLE_STATUSES.include?((e[:status] || :active).to_sym) }
  ranked   = Helpers::FitnessEvaluator.rank(eligible)
  bottom_n = ranked.last(count)

  { success: true, candidates: bottom_n, count: bottom_n.size, total_evaluated: eligible.size }
end