legionio 1.4.47 → 1.4.48

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61d1b58d973cadaa88f3236a2d191452324ce20721fb6a41bf9b08488e077754
-  data.tar.gz: '09129066576304957d34a58a8c54731e8228b3d5a45603592ee9b9ce10f72c55'
+  metadata.gz: d7a08e02740d6be6ecb76c91c3ee6f3a2ed8f594801994e8005c1ec3e3a3b47c
+  data.tar.gz: c45901fb93e4e97063e3044eee0d5646a50447acb818055ff75428a6c5f490a8
 SHA512:
-  metadata.gz: 4e9bfacc58941fb83fe9725779d8a500b514e483dfd84dc759a7184e548b43379252c638007ced10de99164ee749cc9dd7a33134e31e4c0bd8605e6307648d8f
-  data.tar.gz: 989f282c012adb51747e8bbb143e29eabf1c213fd0ad7b531737f98cb948791a6e163c13fa5c1a73d0a5da20efa4cfabad237d90e0e3adbaa21d05c2a8cbc5dc
+  metadata.gz: 23eb01d19c9e38ab19d0bf28f5f2f9d32cb7bd64a47abd1fa0833b2e7d7ba13963c62eda860b43d5745cc54d77e4bacd94086e4749351e0b3af0489dd7ee5dc5
+  data.tar.gz: f436f935e81de29c1364022aad090c0e7c8bd7f1ee9419a1b33aaf1bb66800ffa117f699047ed02f314498161db79ad82193863893f5f538e9e08cf0147272b1

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Legion Changelog
 
+## [1.4.48] - 2026-03-17
+
+### Added
+- `Legion::Capacity::Model`: workforce capacity calculation (throughput, utilization, forecast, per-worker stats)
+- `GET /api/capacity`: aggregate capacity across active workers
+- `GET /api/capacity/forecast`: projected capacity with configurable growth rate and period
+- `GET /api/capacity/workers`: per-worker capacity breakdown
+
 ## [1.4.47] - 2026-03-17
 
 ### Fixed

data/lib/legion/api/capacity.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative '../capacity/model'
+
+module Legion
+  class API < Sinatra::Base
+    module Routes
+      module Capacity
+        def self.registered(app)
+          app.get '/api/capacity' do
+            workers = Routes::Capacity.fetch_worker_list
+            model = Legion::Capacity::Model.new(workers: workers)
+            json_response(model.aggregate)
+          end
+
+          app.get '/api/capacity/forecast' do
+            workers = Routes::Capacity.fetch_worker_list
+            model = Legion::Capacity::Model.new(workers: workers)
+            forecast = model.forecast(
+              days:        (params[:days] || 30).to_i,
+              growth_rate: (params[:growth_rate] || 0).to_f
+            )
+            json_response(forecast)
+          end
+
+          app.get '/api/capacity/workers' do
+            workers = Routes::Capacity.fetch_worker_list
+            model = Legion::Capacity::Model.new(workers: workers)
+            json_response(model.per_worker_stats)
+          end
+        end
+
+        def self.fetch_worker_list
+          return [] unless defined?(Legion::Data::Model::DigitalWorker)
+
+          Legion::Data::Model::DigitalWorker.all.map do |w|
+            { worker_id: w.worker_id, status: w.lifecycle_state }
+          end
+        rescue StandardError
+          []
+        end
+      end
+    end
+  end
+end

data/lib/legion/api.rb

@@ -29,6 +29,7 @@ require_relative 'api/rbac'
 require_relative 'api/auth'
 require_relative 'api/auth_worker'
 require_relative 'api/auth_human'
+require_relative 'api/capacity'
 require_relative 'api/audit'
 require_relative 'api/metrics'
 
@@ -102,6 +103,7 @@ module Legion
     register Routes::Auth
     register Routes::AuthWorker
     register Routes::AuthHuman
+    register Routes::Capacity
     register Routes::Audit
     register Routes::Metrics
 

data/lib/legion/capacity/model.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Legion
+  module Capacity
+    class Model
+      DEFAULTS = {
+        tasks_per_second:   10,
+        utilization_target: 0.7,
+        availability_hours: 24,
+        overhead_factor:    0.15
+      }.freeze
+
+      def initialize(workers:, config: {})
+        @workers = Array(workers)
+        @config = DEFAULTS.merge(config)
+      end
+
+      def aggregate
+        active = @workers.select { |w| active_worker?(w) }
+        tps = @config[:tasks_per_second]
+        {
+          total_workers:            @workers.size,
+          active_workers:           active.size,
+          max_throughput_tps:       active.size * tps,
+          effective_throughput_tps: (active.size * tps * @config[:utilization_target]).round,
+          utilization_target:       @config[:utilization_target],
+          availability_hours:       @config[:availability_hours]
+        }
+      end
+
+      def forecast(days: 30, growth_rate: 0.0)
+        current = aggregate
+        projected = (current[:active_workers] * (1 + (growth_rate * days / 30.0))).ceil
+        tps = @config[:tasks_per_second]
+        {
+          period_days:             days,
+          growth_rate:             growth_rate,
+          current_workers:         current[:active_workers],
+          projected_workers:       projected,
+          projected_max_tps:       projected * tps,
+          projected_effective_tps: (projected * tps * @config[:utilization_target]).round
+        }
+      end
+
+      def per_worker_stats
+        @workers.map do |w|
+          id = w[:worker_id] || w[:id] || 'unknown'
+          {
+            worker_id:    id,
+            status:       w[:status] || w[:lifecycle_state] || 'unknown',
+            capacity_tps: active_worker?(w) ? @config[:tasks_per_second] : 0
+          }
+        end
+      end
+
+      private
+
+      def active_worker?(worker)
+        status = (worker[:status] || worker[:lifecycle_state]).to_s
+        %w[active running].include?(status)
+      end
+    end
+  end
+end

data/lib/legion/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Legion
-  VERSION = '1.4.47'
+  VERSION = '1.4.48'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.4.47
+  version: 1.4.48
 platform: ruby
 authors:
 - Esity
@@ -320,6 +320,7 @@ files:
 - lib/legion/api/auth.rb
 - lib/legion/api/auth_human.rb
 - lib/legion/api/auth_worker.rb
+- lib/legion/api/capacity.rb
 - lib/legion/api/chains.rb
 - lib/legion/api/coldstart.rb
 - lib/legion/api/events.rb
@@ -348,6 +349,7 @@ files:
 - lib/legion/audit.rb
 - lib/legion/audit/hash_chain.rb
 - lib/legion/audit/siem_export.rb
+- lib/legion/capacity/model.rb
 - lib/legion/catalog.rb
 - lib/legion/chat/notification_bridge.rb
 - lib/legion/chat/notification_queue.rb