lex-scheduler 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f627c7b35c725fb68a940b2760985eca4ae6bc044e7289b04f0c49f6c99bbbf8
-  data.tar.gz: 51984b70761ea202d0862c717b55a379f200ed2b6ed04684741abf486ff7aa3d
+  metadata.gz: c30e79b68a5c57ce1c69e7acddcce1bc472d16dfd14dde5bba5ab7c90bc14130
+  data.tar.gz: b38c37b9f1822a06a3a970e1aba03ef9c4650488fd6caad4ec733b624ee82c1f
 SHA512:
-  metadata.gz: bbb5f95b574bd34b3a631986e68db36846d25887489784b2bdacacd3308d7ec714b1dd854c7d797cfa560f6ae8a0bb02822ef1f19fc7e0ca0b63518355ec2b17
-  data.tar.gz: e98ae730b108108aead10e234af77dc5e1f27a7f10a84aad8fad553b272aa7aed58da8a783f7a93219454dc8c5a54a71581b787a2a2f05ce736f09b8cdef0393
+  metadata.gz: 19570dc6a5141dbd6f293aa4ff6f1cdcc9e3629986d1c265224322ca1655707d6ede50294c826c8555decf6c42759a7987a2c55f33a1d7dbf29a203137aa7f50
+  data.tar.gz: 9239fbc82e2c015af2edc457d00f15611969f1e81726bf027ae769194173186c180a45575e4b2ac178a13b7ac5337ba4117fb05d46365837f2e08625ef283f87

data/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ci:
+    uses: LegionIO/.github/.github/workflows/ci.yml@main
+
+  release:
+    needs: ci
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    uses: LegionIO/.github/.github/workflows/release.yml@main
+    secrets:
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/.rubocop.yml

@@ -1,25 +1,50 @@
+AllCops:
+  TargetRubyVersion: 3.4
+  NewCops: enable
+  SuggestExtensions: false
+
 Layout/LineLength:
-  Max: 120
+  Max: 160
+
+Layout/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: space
+
+Layout/HashAlignment:
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+
 Metrics/MethodLength:
-  Max: 30
+  Max: 50
+
 Metrics/ClassLength:
   Max: 1500
+
+Metrics/ModuleLength:
+  Max: 1500
+
 Metrics/BlockLength:
-  Max: 50
+  Max: 40
+  Exclude:
+    - 'spec/**/*'
+
 Metrics/AbcSize:
-  Max: 100
+  Max: 60
+
 Metrics/CyclomaticComplexity:
   Max: 15
+
 Metrics/PerceivedComplexity:
-  Max: 20
+  Max: 17
+
 Style/Documentation:
   Enabled: false
-AllCops:
-  TargetRubyVersion: 2.5
-  NewCops: enable
+
+Style/SymbolArray:
+  Enabled: true
+
 Style/FrozenStringLiteralComment:
-  Enabled: false
+  Enabled: true
+  EnforcedStyle: always
+
 Naming/FileName:
   Enabled: false
-Style/ClassAndModuleChildren:
-  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## [0.2.0] - 2026-03-17
+
+### Added
+- `Runners::ModeScheduler`: time-based operating mode evaluation (active/idle/dream/maintenance)
+- `Runners::ModeTransition`: orchestrated mode transitions with critical task blocking and force override
+- `Runners::EmergencyPromotion`: immediate active mode promotion on critical events (extinction, consent violation)
+- Configurable schedules, emergency patterns, and transition settings
+
+### Fixed
+- Emergency promotion logging uses safe method dispatch for private `Legion::Logging.warn`
+
+## [0.1.4] - 2026-03-13
+
+### Added
+- Initial release

data/CLAUDE.md

@@ -0,0 +1,88 @@
+# lex-scheduler: Cron and Interval Task Scheduling for LegionIO
+
+**Repository Level 3 Documentation**
+- **Parent**: `/Users/miverso2/rubymine/legion/extensions-core/CLAUDE.md`
+- **Grandparent**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+
+## Purpose
+
+Core Legion Extension that manages scheduled, delayed, and cron-style task execution. Reads schedule definitions from the database (interval seconds or cron expressions via `fugit`), determines which tasks are due, and publishes them to the message bus. Uses a distributed lock via `Legion::Cache` to ensure only one node runs the scheduler at a time. Requires `legion-data` (`data_required? true`).
+
+**GitHub**: https://github.com/LegionIO/lex-scheduler
+**License**: MIT
+**Version**: 0.1.3
+
+## Architecture
+
+```
+Legion::Extensions::Scheduler
+├── Actors/
+│   ├── RunScheduler       # Every-type actor: periodically calls schedule_tasks
+│   └── ScheduleTask       # Every-type actor: periodically publishes refresh messages
+├── Runners/
+│   └── Schedule           # Core scheduling logic
+│       ├── schedule_tasks   # Queries DB for due schedules, publishes task messages
+│       ├── send_task        # Routes to Dynamic or SendTask (transformation path)
+│       ├── refresh          # Acquires distributed scheduler lock via cache (2s TTL)
+│       └── push_refresh     # Broadcasts refresh message to cluster
+├── Data/
+│   ├── Models/
+│   │   ├── Schedule       # Sequel model: function_id, interval, cron, active, last_run,
+│   │   │                  #   task_ttl, payload (JSON), transformation (ERB)
+│   │   └── ScheduleLog    # Execution history
+│   └── Migrations/
+│       ├── 001_schedule_table
+│       ├── 002_schedule_log
+│       ├── 003_schedule_indexes
+│       ├── 004_schedule_logs_indexes
+│       ├── 005_add_payload_column
+│       └── 006_add_transform_to_schedule
+└── Transport/
+    ├── Queues/Schedule    # Schedule queue
+    └── Messages/
+        ├── Refresh        # Cluster-wide refresh notification
+        └── SendTask       # Task execution message (transformation path)
+```
+
+## Key Design Patterns
+
+### Distributed Lock
+
+Uses `Legion::Cache.set('scheduler_schedule_lock', node_name, 2)` to ensure only one node in the cluster runs `schedule_tasks` at a time. The lock has a 2-second TTL, refreshed each cycle via `refresh`.
+
+### Dual Schedule Types
+
+- **Interval**: Integer seconds since last run (`row.interval > 0`)
+- **Cron**: Cron expression string parsed by `Fugit.parse`. Supports both duration strings (`Fugit::Duration`, responds to `to_sec`) and standard cron expressions (`Fugit::Cron`, responds to `previous_time`)
+
+### Transformation Support
+
+Scheduled tasks can include an ERB `transformation` column. If present, `send_task` routes through `task.subtask.transform` (via `lex-transformer`) instead of `Legion::Transport::Messages::Dynamic`.
+
+## Dependencies
+
+| Gem | Purpose |
+|-----|---------|
+| `fugit` (>= 1.9) | Cron expression parsing (supports duration and cron syntax) |
+| `legion-data` | Required - schedule persistence |
+| `legion-cache` | Required - distributed scheduler lock |
+
+## Database Schema
+
+**schedules**: `id`, `function_id`, `interval`, `cron`, `active`, `last_run`, `task_ttl`, `payload` (JSON), `transformation` (ERB template)
+
+**schedule_logs**: Execution history linked to schedules
+
+## Testing
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+Spec files include `fugit_spec.rb` for cron expression parsing.
+
+---
+
+**Maintained By**: Matthew Iverson (@Esity)

data/Dockerfile

@@ -0,0 +1,9 @@
+FROM legionio/legion:latest
+LABEL maintainer="Matthew Iverson <matthewdiverson@gmail.com>"
+
+RUN mkdir /etc/legionio
+RUN apk update && apk add build-base tzdata postgresql-dev mysql-client mariadb-dev tzdata gcc git
+
+COPY . ./
+RUN gem install lex-scheduler legion-data --no-document --no-prerelease
+CMD ruby --yjit $(which legionio)

data/Gemfile

@@ -1,3 +1,12 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 gemspec
+
+gem 'bundler', '>= 2'
+gem 'legionio'
+gem 'rake'
+gem 'rspec'
+gem 'rubocop'
+gem 'simplecov'

data/Gemfile.lock

@@ -0,0 +1,166 @@
+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/README.md

@@ -1,6 +1,46 @@
-# Legion::Extensions::Scheduler
-Used to schedule tasks cron style inside Legion
+# lex-scheduler
+
+Cron and interval task scheduling for [LegionIO](https://github.com/LegionIO/LegionIO). Reads schedule definitions from the database, determines which tasks are due, and publishes them to the message bus. Uses a distributed lock via `legion-cache` to ensure only one node runs the scheduler at a time.
+
+This is a core LEX required for scheduled task execution.
+
+## Installation
+
+```bash
+gem install lex-scheduler
+```
+
+## Usage
+
+Schedules are stored in the database with either a cron expression or an interval:
+
+- **Interval**: Run every N seconds since the last completion (integer)
+- **Cron**: Run at specific times using standard cron syntax (`*/5 * * * *`) or human-readable expressions (`every day at noon`) parsed by `fugit`
+
+Schedules can also carry a `transformation` ERB template. If present, the scheduled task is routed through `lex-transformer` before execution.
+
+### Adding Schedules
+
+Insert records into the `schedules` table via `legion-data`:
+
+```ruby
+Legion::Extensions::Scheduler::Data::Models::Schedule.insert(
+  function_id: 42,
+  interval:    300,          # run every 5 minutes
+  active:      1,
+  last_run:    Time.now,
+  payload:     '{}'
+)
+```
+
+## Requirements
+
+- Ruby >= 3.4
+- [LegionIO](https://github.com/LegionIO/LegionIO) framework
+- `legion-data` (schedule persistence)
+- `legion-cache` (distributed scheduler lock)
+- `fugit` >= 1.9 (cron expression parsing)
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+MIT

data/docker_deploy.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+name = 'scheduler'
+require "./lib/legion/extensions/#{name}/version"
+version = Legion::Extensions::Scheduler::VERSION
+
+puts "Building docker image for Legion v#{version}"
+system("docker build --tag legionio/lex-#{name}:v#{version} .")
+puts 'Pushing to hub.docker.com'
+system("docker push legionio/lex-#{name}:v#{version}")
+system("docker tag legionio/lex-#{name}:v#{version} legionio/lex-#{name}:latest")
+system("docker push legionio/lex-#{name}:latest")
+puts 'completed'

data/lex-scheduler.gemspec

@@ -10,27 +10,21 @@ Gem::Specification.new do |spec|
 
   spec.summary       = 'LEX::Scheduler'
   spec.description   = 'Schedules and manages delayed, async and cron style tasks'
-  spec.homepage      = 'https://bitbucket.org/legion-io/lex-scheduler'
+  spec.homepage      = 'https://github.com/LegionIO/lex-scheduler'
   spec.license       = 'MIT'
-  spec.required_ruby_version = Gem::Requirement.new('>= 2.5.0')
+  spec.required_ruby_version = '>= 3.4'
 
   spec.metadata['homepage_uri'] = spec.homepage
-  spec.metadata['source_code_uri'] = 'https://bitbucket.org/legion-io/lex-scheduler'
-  spec.metadata['documentation_uri'] = 'https://legionio.atlassian.net/wiki/spaces/LEX/pages/612139049'
-  spec.metadata['changelog_uri'] = 'https://legionio.atlassian.net/wiki/spaces/LEX/pages/612171789'
-  spec.metadata['bug_tracker_uri'] = 'https://bitbucket.org/legion-io/lex-scheduler/issues'
+  spec.metadata['source_code_uri'] = 'https://github.com/LegionIO/lex-scheduler'
+  spec.metadata['documentation_uri'] = 'https://github.com/LegionIO/lex-scheduler'
+  spec.metadata['changelog_uri'] = 'https://github.com/LegionIO/lex-scheduler'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/LegionIO/lex-scheduler/issues'
+  spec.metadata['rubygems_mfa_required'] = 'true'
 
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'fugit', '>= 1.3.9'
-
-  spec.add_development_dependency 'legionio'
-  spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec'
-  spec.add_development_dependency 'rubocop'
-  spec.add_development_dependency 'simplecov'
+  spec.add_dependency 'fugit', '>= 1.9'
 end

data/lib/legion/extensions/scheduler/actors/run_scheduler.rb

@@ -1,23 +1,31 @@
-module Legion::Extensions::Scheduler::Actor
-  class RunScheduler < Legion::Extensions::Actors::Every
-    def runner_function
-      'schedule_tasks'
-    end
+# frozen_string_literal: true
 
-    def runner_class
-      Legion::Extensions::Scheduler::Runners::Schedule
-    end
+module Legion
+  module Extensions
+    module Scheduler
+      module Actor
+        class RunScheduler < Legion::Extensions::Actors::Every
+          def runner_function
+            'schedule_tasks'
+          end
 
-    def use_runner?
-      false
-    end
+          def runner_class
+            Legion::Extensions::Scheduler::Runners::Schedule
+          end
 
-    def check_subtask?
-      false
-    end
+          def use_runner?
+            false
+          end
+
+          def check_subtask?
+            false
+          end
 
-    def generate_task?
-      false
+          def generate_task?
+            false
+          end
+        end
+      end
     end
   end
 end

data/lib/legion/extensions/scheduler/actors/schedule_task.rb

@@ -1,23 +1,31 @@
-module Legion::Extensions::Scheduler::Actor
-  class ScheduleTask < Legion::Extensions::Actors::Every
-    def runner_function
-      'push_refresh'
-    end
+# frozen_string_literal: true
 
-    def runner_class
-      Legion::Extensions::Scheduler::Runners::Schedule
-    end
+module Legion
+  module Extensions
+    module Scheduler
+      module Actor
+        class ScheduleTask < Legion::Extensions::Actors::Every
+          def runner_function
+            'push_refresh'
+          end
 
-    def use_runner?
-      false
-    end
+          def runner_class
+            Legion::Extensions::Scheduler::Runners::Schedule
+          end
 
-    def check_subtask?
-      false
-    end
+          def use_runner?
+            false
+          end
+
+          def check_subtask?
+            false
+          end
 
-    def generate_task?
-      false
+          def generate_task?
+            false
+          end
+        end
+      end
     end
   end
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Sequel.migration do
   up do
     run '

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Sequel.migration do
   up do
     run '

data/lib/legion/extensions/scheduler/data/migrations/003_schedule_indexes.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Sequel.migration do
   change do
     add_index :schedules, :last_run, name: 'schedules_last_run_index'

data/lib/legion/extensions/scheduler/data/migrations/004_schedule_logs_indexes.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Sequel.migration do
   change do
     add_index :schedule_logs, :schedule_id

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Sequel.migration do
   change do
     alter_table(:schedules) do

data/lib/legion/extensions/scheduler/data/migrations/006_add_transform_to_schedule.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Sequel.migration do
   change do
     alter_table(:schedules) do

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

@@ -1,7 +1,17 @@
-module Legion::Extensions::Scheduler::Data::Model
-  class Schedule < Sequel::Model
-    one_to_many :schedule_logs
-    # many_to_one :task, class: Legion::Data::Model::Task
-    many_to_one :function, class: '::Legion::Data::Model::Function'
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Scheduler
+      module Data
+        module Model
+          class Schedule < Sequel::Model
+            one_to_many :schedule_logs
+            # many_to_one :task, class: Legion::Data::Model::Task
+            many_to_one :function, class: '::Legion::Data::Model::Function'
+          end
+        end
+      end
+    end
   end
 end

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

@@ -1,7 +1,17 @@
-module Legion::Extensions::Scheduler::Data::Model
-  class Schedule < Sequel::Model
-    one_to_many :schedule_logs
-    many_to_one :task
-    many_to_one :function
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Scheduler
+      module Data
+        module Model
+          class Schedule < Sequel::Model
+            one_to_many :schedule_logs
+            many_to_one :task
+            many_to_one :function
+          end
+        end
+      end
+    end
   end
 end