lex-task_pruner 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0fd67ef8d795f7c241e8f54b68582d291e70d3f0cec016e612024196eb1c58d3
+  data.tar.gz: 12a0ad834c9438b56414c7218770597c2584bf50bf8b37414bcbb975562d89c7
+SHA512:
+  metadata.gz: 24141b90fc334cf90ff45a45e480bb5b5644586c904166622b6157e3e73e444fb2a202234fba1121ecc0c263f83602fd44d091ca9e517e5ce3f6916e65ba320f
+  data.tar.gz: 6492c8f2a33470373d819d97e92490c29f2ea89a7154d79c003ff5c69a048b9502c8f010e815c81abeaee59bd7465d8779a9e9406a5a5dec6e7bbff47c9ebb1f

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

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

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

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+## [0.1.1] - 2026-03-18
+
+### Fixed
+- `find_expired` status filter now applied (was silently dropped due to missing reassignment)
+- `find_expired` uses cross-DB `Sequel.lit` instead of MySQL-specific `DATE_SUB(SYSDATE())`
+
+### Added
+- `delete_task(task_id:)` deletes a specific task by ID (was an empty stub)
+- `expire_queued(age:, limit:)` marks stuck queued tasks as `task.expired` (was incomplete)
+- All three runner methods return structured `{ success:, ... }` result hashes
+- 13 new specs for `find_expired`, `delete_task`, and `expire_queued`
+- Guard clauses on `include` statements for standalone loading
+
+## [0.1.0]
+
+### Added
+- Initial release

data/CLAUDE.md

@@ -0,0 +1,64 @@
+# lex-task_pruner: Task History Cleanup 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 prunes old task history records from the LegionIO database. Runs periodically to prevent unbounded growth of task logs and status records. Requires `legion-data` (`data_required? true`).
+
+**GitHub**: https://github.com/LegionIO/task_pruner
+**License**: MIT
+**Version**: 0.1.1
+
+## Architecture
+
+```
+Legion::Extensions::TaskPruner
+└── Runners/
+    └── Prune              # Task cleanup logic (no explicit actor - auto-generated subscription)
+        ├── find_expired   # Delete tasks older than N days (default: 31), limited batch size
+        ├── delete_task    # Delete a specific task by task_id
+        └── expire_queued  # Mark stuck queued tasks as task.expired
+```
+
+No explicit actors directory - the framework auto-generates a subscription actor for the Prune runner.
+
+## Key Files
+
+| Path | Purpose |
+|------|---------|
+| `lib/legion/extensions/task_pruner.rb` | Entry point (`data_required? true`) |
+| `lib/legion/extensions/task_pruner/runners/prune.rb` | Pruning logic |
+
+## Runner Details
+
+**`find_expired(age: 31, limit: 1000, status: ['task.completed'], **)`**
+Deletes task records older than `age` days using `Sequel.lit('created <= ?', cutoff)` for cross-DB compatibility. Runs in batches up to `limit`. Status filter is applied unless `status` is `'*'`, `nil`, or empty string.
+
+**`delete_task(task_id:, **)`**
+Deletes a specific task by primary key. Returns `{ success: false, error: 'task not found' }` if missing.
+
+**`expire_queued(age: 1, limit: 10, **)`**
+Finds tasks stuck in `conditioner.queued`, `transformer.queued`, or `task.queued` status older than `age` days and updates their status to `task.expired`.
+
+## Dependencies
+
+| Gem | Purpose |
+|-----|---------|
+| `legion-data` | Database access for task history tables |
+
+## Testing
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+Spec count: 14 examples
+
+---
+
+**Maintained By**: Matthew Iverson (@Esity)

data/Dockerfile

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

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+group :test do
+  gem 'rake'
+  gem 'rspec'
+  gem 'rspec_junit_formatter'
+  gem 'rubocop'
+  gem 'simplecov'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Esity
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,35 @@
+# lex-task_pruner
+
+Task history cleanup extension for [LegionIO](https://github.com/LegionIO/LegionIO). Prunes old task history records from the database to prevent unbounded growth of task logs and status records.
+
+## Installation
+
+```bash
+gem install lex-task_pruner
+```
+
+## Functions
+
+- **find_expired** - Delete completed tasks older than N days (default: 31 days, batch size: 1000)
+- **delete_task** - Delete a specific task by ID
+- **expire_queued** - Query tasks stuck in queued statuses (conditioner.queued, transformer.queued, task.queued)
+
+## Configuration
+
+`find_expired` accepts optional parameters:
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `age` | `31` | Delete tasks older than this many days |
+| `limit` | `1000` | Maximum records to delete per run |
+| `status` | `['task.completed']` | Status filter (currently not applied due to a bug - all records older than `age` days are deleted) |
+
+## Requirements
+
+- Ruby >= 3.4
+- [LegionIO](https://github.com/LegionIO/LegionIO) framework
+- `legion-data` (database access required)
+
+## License
+
+MIT

data/lex-task_pruner.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative 'lib/legion/extensions/task_pruner/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'lex-task_pruner'
+  spec.version       = Legion::Extensions::TaskPruner::VERSION
+  spec.authors       = ['Esity']
+  spec.email         = ['matthewdiverson@gmail.com']
+
+  spec.summary       = 'Prunes old task history from LegionIO'
+  spec.description   = 'Prunes old task history from LegionIO'
+  spec.homepage      = 'https://github.com/LegionIO/task_pruner'
+  spec.license       = 'MIT'
+  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{\A(?:test|spec|features)/}) }
+  end
+  spec.require_paths = ['lib']
+  spec.extra_rdoc_files = %w[README.md LICENSE CHANGELOG.md]
+  spec.metadata = {
+    'bug_tracker_uri'       => 'https://github.com/LegionIO/task_pruner/issues',
+    'changelog_uri'         => 'https://github.com/LegionIO/task_pruner/blob/main/CHANGELOG.md',
+    'documentation_uri'     => 'https://github.com/LegionIO/task_pruner',
+    'homepage_uri'          => 'https://github.com/LegionIO/task_pruner',
+    'source_code_uri'       => 'https://github.com/LegionIO/task_pruner',
+    'wiki_uri'              => 'https://github.com/LegionIO/task_pruner/wiki',
+    'rubygems_mfa_required' => 'true'
+  }
+
+  spec.add_dependency 'legion-data'
+end

data/lib/legion/extensions/task_pruner/runners/prune.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module TaskPruner
+      module Runners
+        module Prune
+          def find_expired(age: 31, limit: 1000, status: ['task.completed'], **)
+            log.debug("purging old completed tasks with an age > #{age} days, limit: #{limit}")
+            cutoff = Time.now - (age * 86_400)
+            dataset = Legion::Data::Model::Task
+                      .where(Sequel.lit('created <= ?', cutoff))
+                      .limit(limit)
+            dataset = dataset.where(status: status) unless ['*', nil, ''].include?(status)
+            count = dataset.count
+            log.debug("Deleting #{count} records") if count.positive?
+            dataset.delete
+            { success: true, deleted: count }
+          end
+
+          def delete_task(task_id:, **)
+            task = Legion::Data::Model::Task[task_id]
+            return { success: false, error: 'task not found' } unless task
+
+            task.delete
+            { success: true, task_id: task_id }
+          end
+
+          def expire_queued(age: 1, limit: 10, **)
+            cutoff = Time.now - (age * 86_400)
+            dataset = Legion::Data::Model::Task
+                      .where(status: ['conditioner.queued', 'transformer.queued', 'task.queued'])
+                      .where(Sequel.lit('created <= ?', cutoff))
+                      .limit(limit)
+            count = dataset.count
+            dataset.update(status: 'task.expired') if count.positive?
+            { success: true, expired: count }
+          end
+
+          include Legion::Extensions::Helpers::Task if defined?(Legion::Extensions::Helpers::Task)
+          include Legion::Extensions::Helpers::Lex if defined?(Legion::Extensions::Helpers::Lex)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module TaskPruner
+      VERSION = '0.1.1'
+    end
+  end
+end

data/lib/legion/extensions/task_pruner.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/task_pruner/version'
+
+module Legion
+  module Extensions
+    module TaskPruner
+      extend Legion::Extensions::Core if Legion::Extensions.const_defined? :Core
+
+      def self.data_required?
+        true
+      end
+
+      def data_required?
+        true
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: lex-task_pruner
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Esity
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: legion-data
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Prunes old task history from LegionIO
+email:
+- matthewdiverson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+files:
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CLAUDE.md
+- Dockerfile
+- Gemfile
+- LICENSE
+- README.md
+- lex-task_pruner.gemspec
+- lib/legion/extensions/task_pruner.rb
+- lib/legion/extensions/task_pruner/runners/prune.rb
+- lib/legion/extensions/task_pruner/version.rb
+homepage: https://github.com/LegionIO/task_pruner
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/LegionIO/task_pruner/issues
+  changelog_uri: https://github.com/LegionIO/task_pruner/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/LegionIO/task_pruner
+  homepage_uri: https://github.com/LegionIO/task_pruner
+  source_code_uri: https://github.com/LegionIO/task_pruner
+  wiki_uri: https://github.com/LegionIO/task_pruner/wiki
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Prunes old task history from LegionIO
+test_files: []