Class: Legion::Extensions::Agentic::Learning::Scaffolding::Helpers::ScaffoldingEngine

Inherits:
Object
  • Object
show all
Includes:
Constants
Defined in:
lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb

Constant Summary

Constants included from Constants

Constants::COMPETENCE_CEILING, Constants::COMPETENCE_FLOOR, Constants::DECAY_RATE, Constants::DEFAULT_COMPETENCE, Constants::FADING_RATE, Constants::FAILURE_SETBACK, Constants::FRUSTRATION_THRESHOLD, Constants::LEARNING_GAIN, Constants::MASTERY_THRESHOLD, Constants::MAX_HISTORY, Constants::MAX_SCAFFOLDS, Constants::MAX_TASKS, Constants::SUPPORT_LEVELS, Constants::ZONE_LABELS, Constants::ZPD_LOWER, Constants::ZPD_UPPER

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ ScaffoldingEngine

Returns a new instance of ScaffoldingEngine.



14
15
16
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 14

def initialize
  @scaffolds = {}
end

Instance Attribute Details

#scaffolds ⇒ Object (readonly)

Returns the value of attribute scaffolds.



12
13
14
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 12

def scaffolds
  @scaffolds
end

Instance Method Details

#adjust_support(scaffold_id:, direction:) ⇒ Object 



57
58
59
60
61
62
63
64
65
66
67
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 57

def adjust_support(scaffold_id:, direction:)
  scaffold = find(scaffold_id)
  return nil unless scaffold

  case direction
  when :increase then scaffold.increase_support!
  when :decrease then scaffold.fade_support!
  end

  scaffold
end

#attempt_scaffolded_task(scaffold_id:, difficulty:, success:) ⇒ Object 



26
27
28
29
30
31
32
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 26

def attempt_scaffolded_task(scaffold_id:, difficulty:, success:)
  scaffold = find(scaffold_id)
  return nil unless scaffold

  scaffold.attempt_task(difficulty: difficulty, success: success)
  scaffold
end

#by_domain(domain:) ⇒ Object 



53
54
55
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 53

def by_domain(domain:)
  @scaffolds.values.select { |s| s.domain == domain }
end

#create_scaffold(skill_name:, domain:, competence: nil) ⇒ Object 



18
19
20
21
22
23
24
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 18

def create_scaffold(skill_name:, domain:, competence: nil)
  trim_scaffolds if @scaffolds.size >= MAX_SCAFFOLDS
  comp = competence.nil? ? DEFAULT_COMPETENCE : competence
  scaffold = Scaffold.new(skill_name: skill_name, domain: domain, competence: comp)
  @scaffolds[scaffold.id] = scaffold
  scaffold
end

#decay_all ⇒ Object 



75
76
77
78
79
80
81
82
83
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 75

def decay_all
  @scaffolds.each_value do |scaffold|
    next if scaffold.mastered?

    decayed = (scaffold.competence - DECAY_RATE).clamp(COMPETENCE_FLOOR, COMPETENCE_CEILING)
    scaffold.instance_variable_set(:@competence, decayed)
  end
  @scaffolds.size
end

#mastered_skills ⇒ Object 



45
46
47
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 45

def mastered_skills
  @scaffolds.values.select(&:mastered?)
end

#overall_competence ⇒ Object 



69
70
71
72
73
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 69

def overall_competence
  return DEFAULT_COMPETENCE if @scaffolds.empty?

  @scaffolds.values.sum(&:competence) / @scaffolds.size
end

#recommend_task(scaffold_id:) ⇒ Object 



34
35
36
37
38
39
40
41
42
43
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 34

def recommend_task(scaffold_id:)
  scaffold = find(scaffold_id)
  return nil unless scaffold

  {
    difficulty:    scaffold.recommended_difficulty,
    support_level: scaffold.support_level,
    zone:          scaffold.current_zone
  }
end

#to_h ⇒ Object 



85
86
87
88
89
90
91
92
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 85

def to_h
  {
    total_scaffolds:    @scaffolds.size,
    mastered_count:     mastered_skills.size,
    zpd_count:          zpd_skills.size,
    overall_competence: overall_competence.round(4)
  }
end

#zpd_skills ⇒ Object 



49
50
51
 
# File 'lib/legion/extensions/agentic/learning/scaffolding/helpers/scaffolding_engine.rb', line 49

def zpd_skills
  @scaffolds.values.select(&:in_zpd?)
end