lex-scheduler 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 04eb06cbdfc67f8e33dba90d2f491d067fd72356ebc84de0968fe0ca5dfb1d8b
-  data.tar.gz: 8943579fcb0855ae53c8f69a96d5647083a9022be81c06906534ce5d77220d5e
+  metadata.gz: c30e79b68a5c57ce1c69e7acddcce1bc472d16dfd14dde5bba5ab7c90bc14130
+  data.tar.gz: b38c37b9f1822a06a3a970e1aba03ef9c4650488fd6caad4ec733b624ee82c1f
 SHA512:
-  metadata.gz: b51b8f0051ecde12d1767cb009a26f5b565dedfbb6ae02c7b073729037c428ead4f0266ad90adcfd46674470c43b6c2e6b6334b6804120ab3c1c31f0b39a85a2
-  data.tar.gz: 0c3dbf65e28030c66f107f97e78e6becab2f348d7a0b044106bc190f1561b508ad9000461f43ac76ac40bf7579d640caf6b34fd497409c35580339b9a32024f6
+  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,26 +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
-  SuggestExtensions: false
+
+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

@@ -6,4 +6,4 @@ RUN apk update && apk add build-base tzdata postgresql-dev mysql-client mariadb-
 
 COPY . ./
 RUN gem install lex-scheduler legion-data --no-document --no-prerelease
-CMD ruby --jit $(which legionio)
+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

@@ -1,118 +1,156 @@
 PATH
   remote: .
   specs:
-    lex-scheduler (0.1.2)
-      fugit (>= 1.3.9)
+    lex-scheduler (0.2.0)
+      fugit (>= 1.9)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    amq-protocol (2.3.2)
-    ast (2.4.2)
-    aws-eventstream (1.1.0)
-    aws-sigv4 (1.2.2)
+    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)
-    bunny (2.17.0)
-      amq-protocol (~> 2.3, >= 2.3.1)
-    concurrent-ruby (1.1.8)
-    concurrent-ruby-ext (1.1.8)
-      concurrent-ruby (= 1.1.8)
-    connection_pool (2.2.3)
-    daemons (1.3.1)
-    dalli (2.7.11)
-    diff-lcs (1.4.4)
-    docile (1.3.5)
-    et-orbi (1.2.4)
+    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.4.2)
-      et-orbi (~> 1.1, >= 1.1.8)
+    fugit (1.12.1)
+      et-orbi (~> 1.4)
       raabro (~> 1.4)
-    json_pure (2.5.1)
-    legion-cache (1.1.1)
+    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 (0.3.0)
+    legion-crypt (1.2.0)
       vault (>= 0.15.0)
-    legion-exceptions (1.1.5)
-    legion-json (1.1.4)
+    legion-json (1.2.0)
       json_pure
-      legion-exceptions (>= 1.1.5)
       multi_json
-    legion-logging (1.1.4)
+    legion-logging (1.2.0)
       rainbow (~> 3)
-    legion-settings (1.1.3)
-      legion-json
-      legion-logging
-    legion-transport (1.1.9)
+    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
-    legionio (0.4.3)
+      legion-settings
+    legionio (1.2.1)
       concurrent-ruby (>= 1.1.7)
       concurrent-ruby-ext (>= 1.1.7)
       daemons (>= 1.3.1)
-      legion-cache
+      legion-cache (>= 0.2.0)
       legion-crypt (>= 0.2.0)
-      legion-exceptions
-      legion-json
-      legion-logging
-      legion-settings
+      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.1.7)
-    multi_json (1.15.0)
-    oj (3.11.2)
-    parallel (1.20.1)
-    parser (3.0.0.0)
+    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)
-    rainbow (3.0.0)
-    rake (13.0.3)
-    redis (4.2.5)
-    regexp_parser (2.1.1)
-    rexml (3.2.4)
-    rspec (3.10.0)
-      rspec-core (~> 3.10.0)
-      rspec-expectations (~> 3.10.0)
-      rspec-mocks (~> 3.10.0)
-    rspec-core (3.10.1)
-      rspec-support (~> 3.10.0)
-    rspec-expectations (3.10.1)
+    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.10.0)
-    rspec-mocks (3.10.2)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-support (3.10.2)
-    rubocop (1.11.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.0.0.0)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml
-      rubocop-ast (>= 1.2.0, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.4.1)
-      parser (>= 2.7.1.5)
-    ruby-progressbar (1.11.0)
-    simplecov (0.21.2)
+      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.12.3)
-    simplecov_json_formatter (0.1.2)
-    thor (1.1.0)
-    tzinfo (2.0.4)
+    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 (2.0.0)
-    vault (0.15.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
@@ -125,4 +163,4 @@ DEPENDENCIES
   simplecov
 
 BUNDLED WITH
-   2.1.4
+   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

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 name = 'scheduler'
 require "./lib/legion/extensions/#{name}/version"

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.require_paths = ['lib']
 
-  spec.add_dependency 'fugit', '>= 1.3.9'
-
-  spec.add_development_dependency 'bundler', '>= 2'
-  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'