lex-tasker 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 629167fdc22f492d3458b37b1414c66c1f89d61ba843d787126901a36653fc42
-  data.tar.gz: 8962a825f8fe27b0abd990b12d94e540fba3103bce7fb73a3dd0190a5701610d
+  metadata.gz: 0ddb16f43ef1fb3c1ac2861f9c76e02d2b45cede2dbe9eb39029916a5ee70fb7
+  data.tar.gz: ca05b76ba9b441705bb70c182adcc442c36dea6aea02e5d477db0d872afb282d
 SHA512:
-  metadata.gz: 55dbbe3d90fa1e06a04321cc36d9f18d44266112dff7956e0e5a46513d350486a65b4000f210b7822c540efc71b5dd2bc1c737160265f48e0316fb983ab60e6a
-  data.tar.gz: e2ddca1cf4926788cecc1d6a6b3953d0bbf718d6aeaa2be442f51d6e7e222c0614e78fbdaa402b5f0d5716af5b5f09759cf5cb9a315d7b539d95c122510549b2
+  metadata.gz: 8f66556dfc6fdf24c90c688641a477d40b0d31ceb702903e7946bb6d5e0d5ecc8c6a49f3570f600a491b95c32552b75c919f88047d9462327b8ffa4f12bcbbd0
+  data.tar.gz: 34f3bc487e7ecb93f54f86139d055249560d0abd0563646a2656f73ac84026754a3f79afb3ab562778cecd72ffb02c7397338a079dfc5870e5486b2022c42989

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/.gitignore

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

data/.rubocop.yml

@@ -1,34 +1,48 @@
+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: 100
+  Max: 50
+
 Metrics/ClassLength:
   Max: 1500
+
+Metrics/ModuleLength:
+  Max: 1500
+
 Metrics/BlockLength:
-  Max: 50
-Metrics/CyclomaticComplexity:
-  Max: 20
+  Max: 40
+
 Metrics/AbcSize:
-  Max: 100
+  Max: 60
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
 Metrics/PerceivedComplexity:
-  Max: 50
-Metrics/ParameterLists:
-  Max: 20
-Layout/SpaceAroundEqualsInParameterDefault:
-  EnforcedStyle: space
-Style/SymbolArray:
-  Enabled: true
-Layout/HashAlignment:
-  EnforcedHashRocketStyle: table
-  EnforcedColonStyle: table
+  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,43 @@
+# Changelog
+
+## [0.3.0] - 2026-03-18
+
+### Added
+- Standalone `Tasker::Client` for programmatic subtask dispatch
+- `expire_queued` implementation (was no-op stub)
+- Shared `Helpers::TaskFinder` module (deduplicated from find_subtask + fetch_delayed)
+
+### Fixed
+- `extend` -> `include` for helper modules (instance methods were unreachable via AMQP dispatch)
+- SQL injection risk: raw string interpolation replaced with Sequel DSL parameterized queries
+- Cross-DB: backtick quoting, `legion.` prefix, `CONCAT()` replaced with Sequel joins
+- `runners/log.rb`: `payload[:node_id]` -> `opts[:node_id]` (NameError fix)
+- `runners/log.rb`: `Node.where(opts[:name])` -> `Node.where(name: opts[:name])`
+- `runners/log.rb`: `runner.values.nil?` -> `runner.nil?` (NoMethodError fix)
+- `runners/log.rb`: `TaskLog.all.delete` -> `TaskLog.dataset.delete` (was no-op)
+- `runners/updater.rb`: added missing `return` on early exit
+- `runners/task_manager.rb`: Sequel chain reassignment for status filter
+- `runners/task_manager.rb`: MySQL `DATE_SUB` -> `Sequel.lit` with Ruby Time
+- `runners/check_subtask.rb`: nil delay guard (`.to_i.zero?`)
+- `runners/check_subtask.rb`: cache mutation via `relationship.dup`
+- `runners/check_subtask.rb`: nil guard after `find_trigger`
+- `runners/check_subtask.rb`: result/results fan-out handles both keys
+- `fetch_delayed` queue TTL from 1ms to 1000ms
+- Entry point `data_required?` is now class method only
+- `Helpers::TaskFinder#subtask_query` extracted to reduce AbcSize in `find_subtasks`
+
+### Removed
+- `helpers/base.rb` (empty stub)
+- `helpers/fetch_delayed.rb` (merged into TaskFinder)
+- `helpers/find_subtask.rb` (merged into TaskFinder)
+- Debug artifact `log.unknown task.class` in updater
+
+## [0.2.3] - 2026-03-17
+
+### Fixed
+- Qualify `status` column as `tasks.status` in SQL JOIN query to resolve ambiguous column reference in `fetch_delayed` helper
+
+## [0.2.2] - 2026-03-13
+
+### Added
+- Initial release

data/CLAUDE.md

@@ -0,0 +1,83 @@
+# lex-tasker: Task Lifecycle Manager for LegionIO
+
+**Repository Level 3 Documentation**
+- **Parent**: `/Users/miverso2/rubymine/legion/extensions-core/CLAUDE.md`
+- **Grandparent**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+
+## Purpose
+
+Legion Extension that manages the full lifecycle of tasks within the framework. Tracks task status, manages subtask relationships, handles delayed task scheduling, extension registration, and provides task logging. Central coordination point for task execution flow. Requires `legion-data` (`data_required? true`).
+
+**GitHub**: https://github.com/LegionIO/lex-tasker
+**License**: MIT
+**Version**: 0.3.0
+
+## Architecture
+
+```
+Legion::Extensions::Tasker
+├── Actors/
+│   ├── CheckSubtask       # Subscription: checks subtask completion status
+│   ├── TaskManager        # Subscription: core task lifecycle management
+│   ├── FetchDelayed       # Subscription: retrieves delayed tasks for execution
+│   ├── FetchDelayedPush   # Periodic actor: triggers FetchDelayed polls
+│   ├── Updater            # Subscription: updates task status/payload records
+│   └── Log                # Subscription: task activity logging
+├── Runners/
+│   ├── CheckSubtask       # check_subtasks: find and dispatch relationship subtasks
+│   ├── TaskManager        # purge_old, expire_queued: task DB maintenance
+│   ├── FetchDelayed       # fetch, push: poll and dispatch delayed tasks
+│   ├── Updater            # update_status: update task columns in DB
+│   └── Log                # add_log, delete_log, delete_task_logs, delete_node_logs, delete_all
+├── Helpers/
+│   ├── Base               # Shared helper utilities
+│   ├── FetchDelayed       # Delayed task query helpers
+│   └── FindSubtask        # Subtask relationship lookup helpers
+└── Transport/
+    ├── Exchanges/Task     # Task exchange
+    ├── Queues/
+    │   ├── CheckSubtask   # Subtask check queue
+    │   ├── TaskMananger   # Task management queue (note: typo in filename)
+    │   ├── FetchDelayed   # Delayed task queue
+    │   ├── Subtask        # Subtask queue
+    │   ├── TaskLog        # Task log queue
+    │   ├── Updater        # Status update queue
+    │   └── LexRegister    # Extension registration queue
+    └── Messages/
+        └── FetchDelayed   # Delayed task poll message
+```
+
+## Key Files
+
+| Path | Purpose |
+|------|---------|
+| `lib/legion/extensions/tasker.rb` | Entry point (`data_required? true`) |
+| `lib/legion/extensions/tasker/runners/check_subtask.rb` | Core subtask dispatch: find relationships, build task hash, insert DB record, publish |
+| `lib/legion/extensions/tasker/runners/task_manager.rb` | `purge_old` (delete old completed tasks), `expire_queued` (queries stale tasks - incomplete, does not delete) |
+| `lib/legion/extensions/tasker/runners/fetch_delayed.rb` | Poll DB for delayed tasks, dispatch when delay elapsed |
+| `lib/legion/extensions/tasker/runners/updater.rb` | `update_status`: update task columns (status, function_args, payload, results) |
+| `lib/legion/extensions/tasker/runners/log.rb` | Task log CRUD against `TaskLog` model |
+
+## CheckSubtask Flow
+
+1. Receives completed task result with `runner_class` and `function`
+2. Looks up trigger function by namespace + name
+3. Queries relationships where `trigger_function_id` matches
+4. For each matching relationship, builds subtask hash with status (`task.delayed` or `conditioner.queued`)
+5. Inserts task record in DB, then publishes to subtask queue (unless delayed)
+
+## Delayed Task Flow
+
+`FetchDelayedPush` (Every actor, every 1 second) publishes a trigger via `push`. `FetchDelayed` (Subscription actor, `fetch` function) polls DB for tasks in `task.delayed` status, checks if `relationship_delay` or `task_delay` has elapsed, then dispatches them. Routing key is chosen based on whether conditions or transformations are present.
+
+## Testing
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+---
+
+**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-tasker legion-data --no-document --no-prerelease
-CMD ruby $(which legionio)
+CMD ruby --yjit $(which legionio)

data/Gemfile

@@ -1,4 +1,12 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in legion-extensions-tasker.gemspec
 gemspec
+
+gem 'bundler', '>= 2'
+gem 'codecov'
+gem 'rake'
+gem 'rspec'
+gem 'rspec_junit_formatter'
+gem 'rubocop'

data/README.md

@@ -1,3 +1,35 @@
-# Legion::Extensions::Tasker
+# lex-tasker
 
-A core LEX
+Task lifecycle manager for [LegionIO](https://github.com/LegionIO/LegionIO). Manages the full lifecycle of tasks within the framework: status tracking, subtask relationships, delayed task scheduling, task logging, and extension registration.
+
+This is a core LEX required for task execution.
+
+## Installation
+
+```bash
+gem install lex-tasker
+```
+
+## Functions
+
+- **CheckSubtask** - After a task completes, find all relationship-linked subtasks and dispatch them (with delay, condition, or transformation routing as appropriate)
+- **TaskManager** - DB housekeeping: purge old completed tasks, expire stale queued tasks
+- **FetchDelayed** - Poll for tasks in `task.delayed` status; dispatch when their delay period has elapsed
+- **Updater** - Update task records (status, function args, payload, results)
+- **Log** - Task activity log CRUD (add, delete by task/node/id, delete all)
+
+## How It Works
+
+When a task completes, its runner calls `check_subtasks` via the task exchange. `lex-tasker` looks up any configured relationships for that function, creates child task records in the database, and publishes them to the appropriate queue - routing through `lex-conditioner`, `lex-transformer`, or directly to the target runner depending on relationship configuration.
+
+Delayed tasks (those with `relationship_delay` or `task_delay`) are stored in the database with status `task.delayed` and dispatched by the `FetchDelayed` runner once their delay period has elapsed.
+
+## Requirements
+
+- Ruby >= 3.4
+- [LegionIO](https://github.com/LegionIO/LegionIO) framework
+- `legion-data` (database persistence required)
+
+## License
+
+MIT

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 

data/docker_deploy.rb

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

data/lex-tasker.gemspec

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'legion/extensions/tasker/version'
@@ -10,24 +12,18 @@ Gem::Specification.new do |spec|
 
   spec.summary       = 'LEX::Tasker manages tasks status from Legion'
   spec.description   = 'This LEX keeps track of tasks and their status'
-  spec.homepage      = 'https://bitbucket.org/legion-io/lex-tasker'
+  spec.homepage      = 'https://github.com/LegionIO/lex-tasker'
   spec.license       = 'MIT'
-  spec.required_ruby_version = Gem::Requirement.new('>= 2.5.0')
+  spec.required_ruby_version = '>= 3.4'
 
   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.metadata['homepage_uri'] = spec.homepage
-  spec.metadata['source_code_uri'] = 'https://bitbucket.org/legion-io/lex-tasker/src'
-  spec.metadata['documentation_uri'] = 'https://legionio.atlassian.net/wiki/spaces/LEX/pages/7733408'
-  spec.metadata['changelog_uri'] = 'https://legionio.atlassian.net/wiki/spaces/LEX/pages/12156936'
-  spec.metadata['bug_tracker_uri'] = 'https://bitbucket.org/legion-io/lex-tasker/issues'
+  spec.metadata['source_code_uri'] = 'https://github.com/LegionIO/lex-tasker'
+  spec.metadata['documentation_uri'] = 'https://github.com/LegionIO/lex-tasker'
+  spec.metadata['changelog_uri'] = 'https://github.com/LegionIO/lex-tasker'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/LegionIO/lex-tasker/issues'
+  spec.metadata['rubygems_mfa_required'] = 'true'
   spec.require_paths = ['lib']
-
-  spec.add_development_dependency 'bundler', '>= 2'
-  spec.add_development_dependency 'codecov'
-  spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec'
-  spec.add_development_dependency 'rspec_junit_formatter'
-  spec.add_development_dependency 'rubocop'
 end

data/lib/legion/extensions/tasker/actors/check_subtask.rb

@@ -1,20 +1,26 @@
-module Legion::Extensions::Tasker
-  module Actor
-    class CheckSubtask < Legion::Extensions::Actors::Subscription
-      def runner_function
-        'check_subtasks'
-      end
+# frozen_string_literal: true
 
-      def check_subtask?
-        false
-      end
+module Legion
+  module Extensions
+    module Tasker
+      module Actor
+        class CheckSubtask < Legion::Extensions::Actors::Subscription
+          def runner_function
+            'check_subtasks'
+          end
 
-      def use_runner?
-        false
-      end
+          def check_subtask?
+            false
+          end
+
+          def use_runner?
+            false
+          end
 
-      def generate_task?
-        false
+          def generate_task?
+            false
+          end
+        end
       end
     end
   end

data/lib/legion/extensions/tasker/actors/fetch_delayed.rb

@@ -1,24 +1,30 @@
-module Legion::Extensions::Tasker
-  module Actor
-    class FetchDelayed < Legion::Extensions::Actors::Subscription
-      def runner_function
-        'fetch'
-      end
+# frozen_string_literal: true
 
-      def runner_class
-        Legion::Extensions::Tasker::Runners::FetchDelayed
-      end
+module Legion
+  module Extensions
+    module Tasker
+      module Actor
+        class FetchDelayed < Legion::Extensions::Actors::Subscription
+          def runner_function
+            'fetch'
+          end
 
-      def use_runner?
-        false
-      end
+          def runner_class
+            Legion::Extensions::Tasker::Runners::FetchDelayed
+          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

data/lib/legion/extensions/tasker/actors/fetch_delayed_push.rb

@@ -1,28 +1,34 @@
-module Legion::Extensions::Tasker
-  module Actor
-    class FetchDelayedPush < Legion::Extensions::Actors::Every
-      def runner_function
-        'push'
-      end
+# frozen_string_literal: true
 
-      def runner_class
-        Legion::Extensions::Tasker::Runners::FetchDelayed
-      end
+module Legion
+  module Extensions
+    module Tasker
+      module Actor
+        class FetchDelayedPush < Legion::Extensions::Actors::Every
+          def runner_function
+            'push'
+          end
 
-      def check_subtask?
-        false
-      end
+          def runner_class
+            Legion::Extensions::Tasker::Runners::FetchDelayed
+          end
 
-      def generate_task?
-        false
-      end
+          def check_subtask?
+            false
+          end
 
-      def use_runner?
-        false
-      end
+          def generate_task?
+            false
+          end
+
+          def use_runner?
+            false
+          end
 
-      def time
-        1
+          def time
+            1
+          end
+        end
       end
     end
   end

data/lib/legion/extensions/tasker/actors/log.rb

@@ -1,12 +1,18 @@
-module Legion::Extensions::Tasker
-  module Actor
-    class Log < Legion::Extensions::Actors::Subscription
-      def check_subtask?
-        false
-      end
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Tasker
+      module Actor
+        class Log < Legion::Extensions::Actors::Subscription
+          def check_subtask?
+            false
+          end
 
-      def generate_task?
-        false
+          def generate_task?
+            false
+          end
+        end
       end
     end
   end

data/lib/legion/extensions/tasker/actors/task_manager.rb

@@ -1,20 +1,26 @@
-module Legion::Extensions::Tasker
-  module Actor
-    class TaskManager < Legion::Extensions::Actors::Subscription
-      def use_runner?
-        true
-      end
+# frozen_string_literal: true
 
-      def check_subtask?
-        true
-      end
+module Legion
+  module Extensions
+    module Tasker
+      module Actor
+        class TaskManager < Legion::Extensions::Actors::Subscription
+          def use_runner?
+            true
+          end
 
-      def generate_task?
-        true
-      end
+          def check_subtask?
+            false
+          end
+
+          def generate_task?
+            false
+          end
 
-      def prefetch
-        1
+          def prefetch
+            1
+          end
+        end
       end
     end
   end

data/lib/legion/extensions/tasker/actors/updater.rb

@@ -1,20 +1,26 @@
-module Legion::Extensions::Tasker
-  module Actor
-    class Updater < Legion::Extensions::Actors::Subscription
-      def runner_function
-        'update_status'
-      end
+# frozen_string_literal: true
 
-      def check_subtask?
-        false
-      end
+module Legion
+  module Extensions
+    module Tasker
+      module Actor
+        class Updater < Legion::Extensions::Actors::Subscription
+          def runner_function
+            'update_status'
+          end
 
-      def generate_task?
-        false
-      end
+          def check_subtask?
+            false
+          end
+
+          def generate_task?
+            false
+          end
 
-      def use_runner?
-        false
+          def use_runner?
+            false
+          end
+        end
       end
     end
   end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative 'helpers/task_finder'
+
+module Legion
+  module Extensions
+    module Tasker
+      class Client
+        include Helpers::TaskFinder
+
+        def initialize(data_model: nil)
+          @data_model = data_model
+        end
+
+        def models_class
+          @data_model || Legion::Data::Model
+        end
+
+        def log
+          @log ||= defined?(Legion::Logging) ? Legion::Logging : Logger.new($stdout)
+        end
+
+        def settings
+          { options: {} }
+        end
+      end
+    end
+  end
+end