lex-scheduler 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c30e79b68a5c57ce1c69e7acddcce1bc472d16dfd14dde5bba5ab7c90bc14130
-  data.tar.gz: b38c37b9f1822a06a3a970e1aba03ef9c4650488fd6caad4ec733b624ee82c1f
+  metadata.gz: 17c661a4da86c3c66a0d66f54c6339e2724766bc2ae0231fadf5f167675e6c28
+  data.tar.gz: f73724797cd54b5932d57d0e83aae28f6f6cf2197312665771887cce22861371
 SHA512:
-  metadata.gz: 19570dc6a5141dbd6f293aa4ff6f1cdcc9e3629986d1c265224322ca1655707d6ede50294c826c8555decf6c42759a7987a2c55f33a1d7dbf29a203137aa7f50
-  data.tar.gz: 9239fbc82e2c015af2edc457d00f15611969f1e81726bf027ae769194173186c180a45575e4b2ac178a13b7ac5337ba4117fb05d46365837f2e08625ef283f87
+  metadata.gz: 320d897e6b2cb4f78f4b1cb52b927cd89ae88d6fb900a35612b0334f566ab96d24009d230f5f88f126367cd3d4065cd9161d2fa957d3e80adc0a52c3bd37bb10
+  data.tar.gz: c3950163ef797ffc297276efd96516eb39406741be6bc9d8d68e089e91a44b819685ba9c0f333ec0a4cbc5f3b3d0afc54d393aa96e3ea06877255cd78632c642

data/.gitignore

@@ -9,3 +9,4 @@
 
 # rspec failure tracking
 .rspec_status
+Gemfile.lock

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.3.0] - 2026-03-18
+
+### Fixed
+- Migrations 001/002 rewritten as Sequel DSL (cross-DB: SQLite, PostgreSQL, MySQL)
+- Migration 005 column type `File` -> `String, text: true`
+- ScheduleLog model class name (was defining duplicate `Schedule`)
+- Queue TTL from 5ms to 5000ms (messages were expiring instantly)
+- Nil guard on `last_run` (was TypeError on new schedules)
+- Nil guard on function lookup (was NoMethodError on missing function)
+- Removed dead cron guard (`Time.now < previous_time` was always false)
+- ScheduleLog records now created after each dispatch
+- Entry point `data_required?` is now class method only (framework requirement)
+
+### Added
+- Standalone `Scheduler::Client` for programmatic schedule management
+- Comprehensive spec coverage (92%+)
+
+### Removed
+- ModeScheduler, ModeTransition, EmergencyPromotion runners (dead code, no actor wiring)
+- Dead `message_example` in Refresh message (copy-paste from lex-node)
+
 ## [0.2.0] - 2026-03-17
 
 ### Added

data/CLAUDE.md

@@ -10,7 +10,7 @@ Core Legion Extension that manages scheduled, delayed, and cron-style task execu
 
 **GitHub**: https://github.com/LegionIO/lex-scheduler
 **License**: MIT
-**Version**: 0.1.3
+**Version**: 0.3.0
 
 ## Architecture
 

data/Gemfile

@@ -4,9 +4,11 @@ source 'https://rubygems.org'
 
 gemspec
 
-gem 'bundler', '>= 2'
-gem 'legionio'
-gem 'rake'
-gem 'rspec'
-gem 'rubocop'
-gem 'simplecov'
+group :test do
+  gem 'rake'
+  gem 'rspec', '~> 3.13'
+  gem 'rubocop', '~> 1.75'
+  gem 'sequel'
+  gem 'simplecov'
+  gem 'sqlite3'
+end

data/lib/legion/extensions/scheduler/client.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'fugit'
+require_relative 'runners/schedule'
+
+module Legion
+  module Extensions
+    module Scheduler
+      class Client
+        include Runners::Schedule
+
+        def initialize(data_model: nil, fugit: nil)
+          @data_model = data_model
+          @fugit = fugit || Fugit
+        end
+
+        def models_class
+          @data_model || Data::Model
+        end
+
+        def log
+          @log ||= defined?(Legion::Logging) ? Legion::Logging : Logger.new($stdout)
+        end
+
+        def settings
+          { options: {} }
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/scheduler/data/migrations/001_schedule_table.rb

@@ -1,26 +1,18 @@
 # frozen_string_literal: true
 
 Sequel.migration do
-  up do
-    run '
-      create table schedules (
-        id int auto_increment,
-        function_id int null,
-        active tinyint default 1 not null,
-        `interval` int null,
-        cron varchar(255) null,
-        name varchar(255) null,
-        description blob null,
-        task_ttl int null,
-        last_run datetime null,
-        created datetime default CURRENT_TIMESTAMP not null,
-        updated datetime null,
-        constraint schedules_pk
-          primary key (id)
-      );'
-  end
-
-  down do
-    drop_table :schedules
+  change do
+    create_table(:schedules) do
+      primary_key :id
+      foreign_key :function_id, :functions, null: true
+      String :name, null: false
+      Integer :interval, null: true
+      String :cron, null: true, text: true
+      Integer :task_ttl, null: true
+      TrueClass :active, default: true
+      DateTime :last_run, null: true
+      DateTime :created, default: Sequel::CURRENT_TIMESTAMP
+      DateTime :updated, null: true
+    end
   end
 end

data/lib/legion/extensions/scheduler/data/migrations/002_schedule_log.rb

@@ -1,21 +1,15 @@
 # frozen_string_literal: true
 
 Sequel.migration do
-  up do
-    run '
-      create table schedule_logs (
-        id int auto_increment,
-        schedule_id int not null,
-        status varchar(255) null,
-        time_queued datetime default CURRENT_TIMESTAMP not null,
-        task_id int null,
-        created datetime default CURRENT_TIMESTAMP not null,
-        updated datetime null,
-        constraint schedule_logs_pk primary key (id)
-      );'
-  end
-
-  down do
-    drop_table :schedule_logs
+  change do
+    create_table(:schedule_logs) do
+      primary_key :id
+      foreign_key :schedule_id, :schedules, null: true
+      foreign_key :task_id, :tasks, null: true
+      foreign_key :function_id, :functions, null: true
+      TrueClass :success, null: true
+      String :status, null: true
+      DateTime :created, default: Sequel::CURRENT_TIMESTAMP
+    end
   end
 end

data/lib/legion/extensions/scheduler/data/migrations/005_add_payload_column.rb

@@ -3,7 +3,7 @@
 Sequel.migration do
   change do
     alter_table(:schedules) do
-      add_column :payload, File, null: false, default: '{}'
+      add_column :payload, String, text: true, null: true, default: '{}'
     end
   end
 end

data/lib/legion/extensions/scheduler/data/models/schedule_log.rb

@@ -5,10 +5,8 @@ module Legion
     module Scheduler
       module Data
         module Model
-          class Schedule < Sequel::Model
-            one_to_many :schedule_logs
-            many_to_one :task
-            many_to_one :function
+          class ScheduleLog < Sequel::Model(:schedule_logs)
+            many_to_one :schedule, class: '::Legion::Extensions::Scheduler::Data::Model::Schedule'
           end
         end
       end

data/lib/legion/extensions/scheduler/runners/schedule.rb

@@ -25,25 +25,37 @@ module Legion
             return unless Legion::Cache.get('scheduler_schedule_lock') == Legion::Settings[:client][:name]
 
             models_class::Schedule.where(active: 1).each do |row|
+              last_run = row.values[:last_run] || Time.at(0)
+
               if row.values[:interval].is_a?(Integer) && row.values[:interval].positive?
-                next if (Time.now - row.values[:last_run]) < row.values[:interval]
+                next if (Time.now - last_run) < row.values[:interval]
               elsif row.values[:cron].is_a? String
                 cron_class = Fugit.parse(row.values[:cron])
                 if cron_class.respond_to? :to_sec
-                  next if (Time.now - row.values[:last_run]) < cron_class.to_sec
+                  next if (Time.now - last_run) < cron_class.to_sec
                 elsif cron_class.respond_to? :previous_time
-                  next if Time.now < Time.parse(cron_class.previous_time.to_s)
-                  next if row.values[:last_run] > Time.parse(cron_class.previous_time.to_s)
+                  prev = Time.parse(cron_class.previous_time.to_s)
+                  next if last_run > prev
                 end
               end
 
               function = Legion::Data::Model::Function[row.values[:function_id]]
+              next unless function
 
               send_task(transformation: row.values[:transformation],
                         function_id:    row.values[:function_id],
                         expiration:     row.values[:task_ttl],
                         function:       function.values[:name],
                         **Legion::JSON.load(row.values[:payload]))
+
+              models_class::ScheduleLog.insert(
+                schedule_id: row.values[:id],
+                function_id: row.values[:function_id],
+                success:     true,
+                status:      'dispatched',
+                created:     Sequel::CURRENT_TIMESTAMP
+              )
+
               row.update(last_run: Sequel::CURRENT_TIMESTAMP)
             end
           end

data/lib/legion/extensions/scheduler/transport/messages/refresh.rb

@@ -28,15 +28,6 @@ module Legion
                 runner_class: 'Legion::Extensions::Scheduler::Runners::Schedule'
               }
             end
-
-            def message_example
-              { function:     'push_cluster_secret',
-                node_name:    Legion::Settings[:client][:name],
-                queue_name:   "node.#{Legion::Settings[:client][:name]}",
-                runner_class: 'Legion::Extensions::Node::Runners::Crypt',
-                # public_key: Base64.encode64(Legion::Crypt.public_key) }
-                public_key:   Legion::Crypt.public_key }
-            end
           end
         end
       end

data/lib/legion/extensions/scheduler/transport/queues/schedule.rb

@@ -10,7 +10,7 @@ module Legion
               {
                 arguments:   {
                   'x-single-active-consumer': true,
-                  'x-message-ttl':            5
+                  'x-message-ttl':            5000
                 },
                 auto_delete: false
               }

data/lib/legion/extensions/scheduler/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Scheduler
-      VERSION = '0.2.0'
+      VERSION = '0.3.0'
     end
   end
 end

data/lib/legion/extensions/scheduler.rb

@@ -10,10 +10,6 @@ module Legion
       def self.data_required?
         true
       end
-
-      def data_required?
-        true
-      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-scheduler
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Esity
@@ -38,7 +38,6 @@ files:
 - CLAUDE.md
 - Dockerfile
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -47,6 +46,7 @@ files:
 - lib/legion/extensions/scheduler.rb
 - lib/legion/extensions/scheduler/actors/run_scheduler.rb
 - lib/legion/extensions/scheduler/actors/schedule_task.rb
+- lib/legion/extensions/scheduler/client.rb
 - lib/legion/extensions/scheduler/data/migrations/001_schedule_table.rb
 - lib/legion/extensions/scheduler/data/migrations/002_schedule_log.rb
 - lib/legion/extensions/scheduler/data/migrations/003_schedule_indexes.rb
@@ -55,9 +55,6 @@ files:
 - lib/legion/extensions/scheduler/data/migrations/006_add_transform_to_schedule.rb
 - lib/legion/extensions/scheduler/data/models/schedule.rb
 - lib/legion/extensions/scheduler/data/models/schedule_log.rb
-- lib/legion/extensions/scheduler/runners/emergency_promotion.rb
-- lib/legion/extensions/scheduler/runners/mode_scheduler.rb
-- lib/legion/extensions/scheduler/runners/mode_transition.rb
 - lib/legion/extensions/scheduler/runners/schedule.rb
 - lib/legion/extensions/scheduler/transport/messages/refresh.rb
 - lib/legion/extensions/scheduler/transport/messages/send_task.rb

data/Gemfile.lock

@@ -1,166 +0,0 @@
-PATH
-  remote: .
-  specs:
-    lex-scheduler (0.2.0)
-      fugit (>= 1.9)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    addressable (2.8.9)
-      public_suffix (>= 2.0.2, < 8.0)
-    amq-protocol (2.5.1)
-    ast (2.4.3)
-    aws-eventstream (1.4.0)
-    aws-sigv4 (1.12.1)
-      aws-eventstream (~> 1, >= 1.0.2)
-    base64 (0.3.0)
-    bigdecimal (4.0.1)
-    bunny (2.24.0)
-      amq-protocol (~> 2.3)
-      sorted_set (~> 1, >= 1.0.2)
-    concurrent-ruby (1.3.6)
-    concurrent-ruby-ext (1.3.6)
-      concurrent-ruby (= 1.3.6)
-    connection_pool (2.5.5)
-    daemons (1.4.1)
-    dalli (5.0.2)
-      logger
-    diff-lcs (1.6.2)
-    docile (1.4.1)
-    et-orbi (1.4.0)
-      tzinfo
-    fugit (1.12.1)
-      et-orbi (~> 1.4)
-      raabro (~> 1.4)
-    json (2.19.1)
-    json-schema (6.2.0)
-      addressable (~> 2.8)
-      bigdecimal (>= 3.1, < 5)
-    json_pure (2.8.1)
-    language_server-protocol (3.17.0.5)
-    legion-cache (1.2.0)
-      connection_pool (>= 2.2.3)
-      dalli (>= 2.7)
-      legion-logging
-      legion-settings
-      redis (>= 4.2)
-    legion-crypt (1.2.0)
-      vault (>= 0.15.0)
-    legion-json (1.2.0)
-      json_pure
-      multi_json
-    legion-logging (1.2.0)
-      rainbow (~> 3)
-    legion-settings (1.2.0)
-      legion-json (>= 1.2)
-    legion-transport (1.2.0)
-      bunny (>= 2.17.0)
-      concurrent-ruby (>= 1.1.7)
-      legion-json
-      legion-settings
-    legionio (1.2.1)
-      concurrent-ruby (>= 1.1.7)
-      concurrent-ruby-ext (>= 1.1.7)
-      daemons (>= 1.3.1)
-      legion-cache (>= 0.2.0)
-      legion-crypt (>= 0.2.0)
-      legion-json (>= 0.2.0)
-      legion-logging (>= 0.2.0)
-      legion-settings (>= 0.2.0)
-      legion-transport (>= 1.1.9)
-      lex-node
-      oj (>= 3.10)
-      thor (>= 1)
-    lex-node (0.2.0)
-    lint_roller (1.1.0)
-    logger (1.7.0)
-    mcp (0.8.0)
-      json-schema (>= 4.1)
-    multi_json (1.19.1)
-    net-http-persistent (4.0.8)
-      connection_pool (>= 2.2.4, < 4)
-    oj (3.16.16)
-      bigdecimal (>= 3.0)
-      ostruct (>= 0.2)
-    ostruct (0.6.3)
-    parallel (1.27.0)
-    parser (3.3.10.2)
-      ast (~> 2.4.1)
-      racc
-    prism (1.9.0)
-    public_suffix (7.0.5)
-    raabro (1.4.0)
-    racc (1.8.1)
-    rainbow (3.1.1)
-    rake (13.3.1)
-    rbtree (0.4.6)
-    redis (5.4.1)
-      redis-client (>= 0.22.0)
-    redis-client (0.27.0)
-      connection_pool
-    regexp_parser (2.11.3)
-    rspec (3.13.2)
-      rspec-core (~> 3.13.0)
-      rspec-expectations (~> 3.13.0)
-      rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.6)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.5)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.8)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-support (3.13.7)
-    rubocop (1.85.1)
-      json (~> 2.3)
-      language_server-protocol (~> 3.17.0.2)
-      lint_roller (~> 1.1.0)
-      mcp (~> 0.6)
-      parallel (~> 1.10)
-      parser (>= 3.3.0.2)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.49.0, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.1)
-      parser (>= 3.3.7.2)
-      prism (~> 1.7)
-    ruby-progressbar (1.13.0)
-    simplecov (0.22.0)
-      docile (~> 1.1)
-      simplecov-html (~> 0.11)
-      simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.13.2)
-    simplecov_json_formatter (0.1.4)
-    sorted_set (1.1.0)
-      rbtree
-    thor (1.5.0)
-    tzinfo (2.0.6)
-      concurrent-ruby (~> 1.0)
-    unicode-display_width (3.2.0)
-      unicode-emoji (~> 4.1)
-    unicode-emoji (4.2.0)
-    vault (0.20.0)
-      aws-sigv4
-      base64
-      connection_pool (~> 2.4)
-      net-http-persistent (~> 4.0, >= 4.0.2)
-
-PLATFORMS
-  arm64-darwin-25
-  ruby
-
-DEPENDENCIES
-  bundler (>= 2)
-  legionio
-  lex-scheduler!
-  rake
-  rspec
-  rubocop
-  simplecov
-
-BUNDLED WITH
-   2.6.9

data/lib/legion/extensions/scheduler/runners/emergency_promotion.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module Legion
-  module Extensions
-    module Scheduler
-      module Runners
-        module EmergencyPromotion
-          DEFAULT_PATTERNS = %w[extinction.* governance.consent_violation governance.shadow_ai_detected].freeze
-
-          def check_emergency(event_name:, **)
-            return { promoted: false, reason: 'not_emergency' } unless emergency_pattern?(event_name)
-            return { promoted: false, reason: 'already_active' } if current_mode == :active
-
-            result = transition_to(target_mode: :active, reason: "emergency:#{event_name}", force: true)
-            log_emergency(event_name)
-            { promoted: result[:transitioned], event: event_name, transition: result }
-          end
-
-          private
-
-          def emergency_pattern?(event_name)
-            patterns = emergency_patterns
-            patterns.any? { |p| File.fnmatch?(p, event_name) }
-          end
-
-          def log_emergency(event_name)
-            return unless defined?(Legion::Logging) && Legion::Logging.respond_to?(:warn, true)
-
-            Legion::Logging.send(:warn, "[scheduler] Emergency promotion: #{event_name}")
-          end
-
-          def emergency_patterns
-            settings = scheduler_settings
-            patterns = settings[:emergency_patterns]
-            patterns.is_a?(Array) ? patterns : DEFAULT_PATTERNS
-          end
-        end
-      end
-    end
-  end
-end

data/lib/legion/extensions/scheduler/runners/mode_scheduler.rb

@@ -1,67 +0,0 @@
-# frozen_string_literal: true
-
-module Legion
-  module Extensions
-    module Scheduler
-      module Runners
-        module ModeScheduler
-          MODES = {
-            active:      { tick_interval: 1, cognitive: true, dream: false },
-            idle:        { tick_interval: 5, cognitive: true, dream: false },
-            dream:       { tick_interval: 10, cognitive: false, dream: true },
-            maintenance: { tick_interval: 0, cognitive: false, dream: false }
-          }.freeze
-
-          def evaluate_schedule(current_time: Time.now, **)
-            schedules = load_schedules
-            applicable = schedules.select { |s| matches_time?(s[:schedule], current_time) }
-
-            return { mode: :idle, reason: 'no_matching_schedule', mode_config: MODES[:idle] } if applicable.empty?
-
-            winner = applicable.max_by { |s| s[:priority] || 0 }
-            mode = winner[:mode].to_sym
-            { mode: mode, reason: 'scheduled', schedule: winner, mode_config: MODES[mode] || MODES[:idle] }
-          end
-
-          private
-
-          def matches_time?(schedule, time)
-            case schedule
-            when 'default'
-              true
-            when /\Aweekday:(\d+)-(\d+)\z/
-              start_h = ::Regexp.last_match(1).to_i
-              end_h = ::Regexp.last_match(2).to_i
-              (1..5).include?(time.wday) && time.hour >= start_h && time.hour < end_h
-            when /\Aweekend:(\d+)-(\d+)\z/
-              start_h = ::Regexp.last_match(1).to_i
-              end_h = ::Regexp.last_match(2).to_i
-              [0, 6].include?(time.wday) && time.hour >= start_h && time.hour < end_h
-            when /\Adaily:(\d+)-(\d+)\z/
-              start_h = ::Regexp.last_match(1).to_i
-              end_h = ::Regexp.last_match(2).to_i
-              time.hour >= start_h && time.hour < end_h
-            else
-              false
-            end
-          end
-
-          def load_schedules
-            settings = scheduler_settings
-            raw = settings[:mode_schedule]
-            return [] unless raw.is_a?(Array)
-
-            raw.map { |s| s.transform_keys(&:to_sym) }
-          end
-
-          def scheduler_settings
-            settings = Legion::Settings[:scheduler]
-            settings.is_a?(Hash) ? settings : {}
-          rescue StandardError
-            {}
-          end
-        end
-      end
-    end
-  end
-end

data/lib/legion/extensions/scheduler/runners/mode_transition.rb

@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-module Legion
-  module Extensions
-    module Scheduler
-      module Runners
-        module ModeTransition
-          def transition_to(target_mode:, reason: 'scheduled', force: false, **)
-            current = current_mode
-            target = target_mode.to_sym
-
-            return { transitioned: false, reason: 'already_in_mode' } if current == target
-            return { transitioned: false, reason: 'blocked_by_critical' } if !force && critical_tasks_active?
-
-            apply_mode(target)
-            emit_transition_event(from: current, to: target, reason: reason)
-            { transitioned: true, from: current, to: target, reason: reason }
-          end
-
-          def current_mode(**)
-            if defined?(Legion::Gaia) && Legion::Gaia.respond_to?(:mode)
-              Legion::Gaia.mode
-            else
-              :active
-            end
-          end
-
-          private
-
-          def critical_tasks_active?
-            return false unless defined?(Legion::Data::Model::Task)
-
-            Legion::Data::Model::Task.where(status: 'running', priority: 'critical').any?
-          rescue StandardError
-            false
-          end
-
-          def apply_mode(mode)
-            config = ModeScheduler::MODES[mode] || ModeScheduler::MODES[:idle]
-            return unless defined?(Legion::Gaia) && Legion::Gaia.respond_to?(:heartbeat_interval=)
-
-            Legion::Gaia.heartbeat_interval = config[:tick_interval]
-          end
-
-          def emit_transition_event(from:, to:, reason:)
-            return unless defined?(Legion::Events)
-
-            Legion::Events.emit('scheduler.mode_changed', {
-                                  from: from, to: to, reason: reason, changed_at: Time.now.utc
-                                })
-          end
-        end
-      end
-    end
-  end
-end