active_genie 0.25.1 → 0.26.0

data/lib/active_genie/ranking/ranking.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require_relative '../concerns/loggable'
-require_relative './players_collection'
-require_relative './free_for_all'
-require_relative './elo_round'
-require_relative './ranking_scoring'
+require_relative 'concerns/loggable'
+require_relative 'players_collection'
+require_relative 'free_for_all'
+require_relative 'elo_round'
+require_relative 'ranking_scoring'
 
 # This class orchestrates player ranking through multiple evaluation stages
 # using Elo ranking and free-for-all match simulations.
@@ -38,7 +38,8 @@ module ActiveGenie
         new(...).call
       end
 
-      def initialize(_param_players, criteria, reviewers: [], config: {})
+      def initialize(param_players, criteria, reviewers: [], config: {})
+        @param_players = param_players
         @criteria = criteria
         @reviewers = Array(reviewers).compact.uniq
         @config = ActiveGenie.configuration.merge(config)
@@ -48,30 +49,30 @@ module ActiveGenie
       def call
         @players = create_players
 
-        set_initial_player_scores!
-        eliminate_obvious_bad_players!
+        ActiveGenie::Logger.with_context(log_context) do
+          set_initial_player_scores!
+          eliminate_obvious_bad_players!
 
-        while @players.elo_eligible?
-          elo_report = run_elo_round!
-          eliminate_relegation_players!
-          rebalance_players!(elo_report)
-        end
+          while @players.elo_eligible?
+            elo_report = run_elo_round!
+            eliminate_relegation_players!
+            rebalance_players!(elo_report)
+          end
 
-        run_free_for_all!
+          run_free_for_all!
+        end
 
         sorted_players
       end
 
-      private
-
       ELIMINATION_VARIATION = 'variation_too_high'
       ELIMINATION_RELEGATION = 'relegation_tier'
 
-      call_with_log_context :log_context
+      private
 
       def create_players
-        players = PlayersCollection.new(param_players)
-        players.each { |p| logger({ code: :new_player, player: p.to_h }) }
+        players = PlayersCollection.new(@param_players)
+        players.each { |p| ActiveGenie::Logger.call({ code: :new_player, player: p.to_h }) }
 
         players
       end
@@ -110,7 +111,7 @@ module ActiveGenie
 
       def sorted_players
         players = @players.sorted
-        logger({ code: :ranking_final, players: players.map(&:to_h) })
+        ActiveGenie::Logger.call({ code: :ranking_final, players: players.map(&:to_h) })
 
         players.map(&:to_h)
       end

data/lib/active_genie/ranking/ranking_scoring.rb

@@ -20,26 +20,8 @@ module ActiveGenie
         ActiveGenie::Logger.with_context(log_context) do
           @reviewers = generate_reviewers
 
-          players_to_score = players_without_score
-          until players_to_score.empty?
-            threads = []
-            mutex = Mutex.new
-
-            # Take up to 3 players for parallel processing
-            current_batch = players_to_score.shift(3)
-
-            current_batch.each do |player|
-              threads << Thread.new(player) do |p|
-                score = generate_score(p)
-
-                mutex.synchronize do
-                  p.score = score
-                end
-              end
-            end
-
-            # Wait for all threads in this batch to complete
-            threads.each(&:join)
+          players_without_score.each do |player|
+            player.score = generate_score(player)
           end
         end
       end

data/lib/active_genie/scoring/generalist.json

@@ -0,0 +1,9 @@
+{
+  "name": "scoring",
+  "description": "Score the text based on the given criteria.",
+  "parameters": {
+    "type": "object",
+    "properties": {},
+    "required": {}
+  }
+}

data/lib/active_genie/scoring/generalist.md

@@ -0,0 +1,46 @@
+Evaluate and score the provided text based on predefined criteria, using a scoring range of 0 to 100 with 100 representing the highest possible score.
+
+Follow the instructions below to ensure a comprehensive and objective assessment.
+
+# Evaluation Process
+
+1. **Analysis**:
+  - Thoroughly compare the text against each criterion for a comprehensive evaluation.
+2. **Document Deviations**:
+  - Identify and document areas where the content does not align with the specified criteria.
+3. **Highlight Strengths**:
+  - Note notable features or elements that enhance the quality or effectiveness of the content.
+4. **Identify Weaknesses**:
+  - Specify areas where the content fails to meet the criteria or where improvements could be made.
+
+# Scoring Fairness
+
+- Ensure the assigned score reflects both the alignment with the criteria and the content's effectiveness.
+- Consider if the fulfillment of other criteria compensates for areas lacking extreme details.
+
+# Scoring Range
+
+Segment scores into five parts before assigning a final score:
+- **Terrible**: 0-20 - Content does not meet the criteria.
+- **Bad**: 21-40 - Content is substandard but meets some criteria.
+- **Average**: 41-60 - Content meets criteria with room for improvement.
+- **Good**: 61-80 - Content exceeds criteria and is above average.
+- **Great**: 81-100 - Content exceeds all expectations.
+
+# Guidelines
+
+- Maintain objectivity and avoid biases.
+- Deconstruct each criterion into actionable components for systematic evaluation.
+- Apply reasonable judgment in assigning a score, justifying your rationale clearly.
+
+# Output Format
+
+- Provide a detailed review including:
+  - A final score (0-100)
+  - Specific reasoning for the assigned score, detailing all evaluated criteria
+  - Include both positive aspects and suggested improvements
+
+# Notes
+
+- Consider edge cases where the text may partially align with criteria.
+- If lacking information, reasonably judge and explain your scoring approach.

data/lib/active_genie/scoring/generalist.rb

@@ -44,21 +44,9 @@ module ActiveGenie
           {  role: 'user', content: "Text to score: #{@text}" }
         ]
 
-        properties = build_properties
-
-        function = {
-          name: 'scoring',
-          description: 'Score the text based on the given criteria.',
-          parameters: {
-            type: 'object',
-            properties:,
-            required: properties.keys
-          }
-        }
-
         result = ::ActiveGenie::Clients::UnifiedClient.function_calling(
           messages,
-          function,
+          build_function,
           config: @config
         )
 
@@ -76,8 +64,20 @@ module ActiveGenie
         result
       end
 
+      PROMPT = File.read(File.join(__dir__, 'generalist.md'))
+
       private
 
+      def build_function
+        properties = build_properties
+
+        function = JSON.parse(File.read(File.join(__dir__, 'generalist.json')), symbolize_names: true)
+        function[:parameters][:properties] = properties
+        function[:parameters][:required] = properties.keys
+
+        function
+      end
+
       def build_properties
         properties = {}
         reviewers.each do |reviewer|
@@ -114,58 +114,6 @@ module ActiveGenie
                          [result['reviewer1'], result['reviewer2'], result['reviewer3']]
                        end
       end
-
-      PROMPT = <<~PROMPT
-        Evaluate and score the provided text based on predefined criteria, using a scoring range of 0 to 100 with 100 representing the highest possible score.
-
-        Follow the instructions below to ensure a comprehensive and objective assessment.
-
-        # Evaluation Process
-
-        1. **Analysis**:
-          - Thoroughly compare the text against each criterion for a comprehensive evaluation.
-
-        2. **Document Deviations**:
-          - Identify and document areas where the content does not align with the specified criteria.
-
-        3. **Highlight Strengths**:
-          - Note notable features or elements that enhance the quality or effectiveness of the content.
-
-        4. **Identify Weaknesses**:
-          - Specify areas where the content fails to meet the criteria or where improvements could be made.
-
-        # Scoring Fairness
-
-        - Ensure the assigned score reflects both the alignment with the criteria and the content's effectiveness.
-        - Consider if the fulfillment of other criteria compensates for areas lacking extreme details.
-
-        # Scoring Range
-
-        Segment scores into five parts before assigning a final score:
-        - **Terrible**: 0-20 - Content does not meet the criteria.
-        - **Bad**: 21-40 - Content is substandard but meets some criteria.
-        - **Average**: 41-60 - Content meets criteria with room for improvement.
-        - **Good**: 61-80 - Content exceeds criteria and is above average.
-        - **Great**: 81-100 - Content exceeds all expectations.
-
-        # Guidelines
-
-        - Maintain objectivity and avoid biases.
-        - Deconstruct each criterion into actionable components for systematic evaluation.
-        - Apply reasonable judgment in assigning a score, justifying your rationale clearly.
-
-        # Output Format
-
-        - Provide a detailed review including:
-          - A final score (0-100)
-          - Specific reasoning for the assigned score, detailing all evaluated criteria
-          - Include both positive aspects and suggested improvements
-
-        # Notes
-
-        - Consider edge cases where the text may partially align with criteria.
-        - If lacking information, reasonably judge and explain your scoring approach.
-      PROMPT
     end
   end
 end

data/lib/active_genie/scoring/recommended_reviewers.rb

@@ -62,8 +62,6 @@ module ActiveGenie
         )
       end
 
-      private
-
       PROMPT = <<~PROMPT
         Identify the top 3 suitable reviewer titles or roles based on the provided text and criteria. Selected reviewers must possess subject matter expertise, offer valuable insights, and ensure diverse yet aligned perspectives on the content.
 
@@ -79,6 +77,8 @@ module ActiveGenie
         - Avoid redundant or overly similar titles/roles to maintain diversity.
       PROMPT
 
+      private
+
       def client
         ::ActiveGenie::Clients::UnifiedClient
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_genie
 version: !ruby/object:Gem::Version
-  version: 0.25.1
+  version: 0.26.0
 platform: ruby
 authors:
 - Radamés Roriz
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-19 00:00:00.000000000 Z
+date: 2025-06-02 00:00:00.000000000 Z
 dependencies: []
 description: |
   The lodash for GenAI, stop reinventing the wheel
@@ -26,6 +26,8 @@ files:
 - lib/active_genie.rb
 - lib/active_genie/battle.rb
 - lib/active_genie/battle/README.md
+- lib/active_genie/battle/generalist.json
+- lib/active_genie/battle/generalist.md
 - lib/active_genie/battle/generalist.rb
 - lib/active_genie/clients/providers/anthropic_client.rb
 - lib/active_genie/clients/providers/base_client.rb
@@ -33,7 +35,6 @@ files:
 - lib/active_genie/clients/providers/google_client.rb
 - lib/active_genie/clients/providers/openai_client.rb
 - lib/active_genie/clients/unified_client.rb
-- lib/active_genie/concerns/loggable.rb
 - lib/active_genie/config/battle_config.rb
 - lib/active_genie/config/data_extractor_config.rb
 - lib/active_genie/config/llm_config.rb
@@ -49,13 +50,17 @@ files:
 - lib/active_genie/configuration.rb
 - lib/active_genie/data_extractor.rb
 - lib/active_genie/data_extractor/README.md
+- lib/active_genie/data_extractor/from_informal.json
 - lib/active_genie/data_extractor/from_informal.rb
+- lib/active_genie/data_extractor/generalist.json
 - lib/active_genie/data_extractor/generalist.md
 - lib/active_genie/data_extractor/generalist.rb
+- lib/active_genie/errors/invalid_log_output_error.rb
 - lib/active_genie/errors/invalid_provider_error.rb
 - lib/active_genie/logger.rb
 - lib/active_genie/ranking.rb
 - lib/active_genie/ranking/README.md
+- lib/active_genie/ranking/concerns/loggable.rb
 - lib/active_genie/ranking/elo_round.rb
 - lib/active_genie/ranking/free_for_all.rb
 - lib/active_genie/ranking/player.rb
@@ -64,6 +69,8 @@ files:
 - lib/active_genie/ranking/ranking_scoring.rb
 - lib/active_genie/scoring.rb
 - lib/active_genie/scoring/README.md
+- lib/active_genie/scoring/generalist.json
+- lib/active_genie/scoring/generalist.md
 - lib/active_genie/scoring/generalist.rb
 - lib/active_genie/scoring/recommended_reviewers.rb
 - lib/tasks/benchmark.rake
@@ -86,7 +93,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.3.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="