lex-detect 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac8b336bd2c34b58a559c0f4b664c728b2c61991d9f88f4a4bc83014ff5fe45f
-  data.tar.gz: 8d6b78909cf1e3c405f6251099f686882bab688496a66588681ad6646e7b2455
+  metadata.gz: 119e238ddb0711af3bb4d23c5c65bb85c910420aa4ce79c1fe28c81950a38d0c
+  data.tar.gz: da4f50f6e3b1653c18d70617ab81630f3f9db6aa01cf6271205882f34df312f6
 SHA512:
-  metadata.gz: e0f94a3e7c7f3ab15a9f27c5646423d98a9c275c203911a8c6d3a44c1c17830c3de2cd1cad4e5d769e5d1662ab54e03daedfb3f885cd579d47ab62ef67c83031
-  data.tar.gz: ac6498c5166dc7cbf6b077be7476b8911c979fe3eb911703840bb87f7944f35a5262581d6918ba4a142c98d37f4373816ac0eb68e7dae9b114f82979e4dd6afe
+  metadata.gz: 1f38552069181a4198433a821b64744f6bdf4cd42be0285c22eccfb4ef219f09f5d5d8a5825ac53c95ded7adb45278d5ca9ef20018c96f2dcac1ad61389da296
+  data.tar.gz: ecb32f15376b6079a1810c161a726f447e1aa6b07a3a187d894fe6393b31d608cc4c0a09227d52aefe88110e6f51ff3f3d9ba1e9e61772463587557600142896

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.3] - 2026-03-20
+
+### Added
+- `Runners::TaskObserver` for monitoring task failure patterns
+- `check_and_publish_failure_patterns` publishes failure pattern events to AMQP for self-healing pipeline integration
+- `extract_gem_name` helper derives gem name from runner class string
+- `build_failure_pattern` creates structured failure pattern hash
+
 ## [0.1.2] - 2026-03-19
 
 ### Added

data/CLAUDE.md

@@ -1,8 +1,8 @@
 # lex-detect: Environment-Aware Extension Discovery
 
 **Repository Level 3 Documentation**
-- **Parent (Level 2)**: `/Users/miverso2/rubymine/legion/extensions-core/CLAUDE.md`
-- **Parent (Level 1)**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+- **Parent**: `/Users/miverso2/rubymine/legion/extensions-core/CLAUDE.md`
+- **Grandparent**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
 
 ## Purpose
 
@@ -10,7 +10,7 @@ Legion Extension that scans the local environment and recommends which `lex-*` e
 
 **GitHub**: https://github.com/LegionIO/lex-detect
 **License**: MIT
-**Version**: 0.1.1
+**Version**: 0.1.2
 
 ## Architecture
 
@@ -19,10 +19,13 @@ Legion::Extensions::Detect
 ├── CATALOG (constant)     # Frozen array of 20 detection rules
 ├── Scanner                # Probes environment, matches against catalog
 ├── Installer              # Gem.install wrapper with dry_run support
+├── Actors/
+│   ├── FullScan (Once)    # Full environment scan at startup
+│   └── DeltaScan (Every)  # Periodic delta scan every 6 hours
 └── Entry Point            # Public API: scan, missing, install_missing!, catalog
 ```
 
-This is NOT a typical LEX — no runners, no actors, no AMQP transport, no Faraday client. It is a local-only utility gem with zero runtime dependencies.
+Local-only utility gem. Actors run scans but do not create AMQP queues.
 
 - `data_required? false` — no database needed
 - `remote_invocable? false` — no AMQP queue creation
@@ -49,12 +52,12 @@ Legion::Extensions::Detect.catalog          # raw CATALOG constant
 
 ## Design Docs
 
-- Design: `docs/plans/2026-03-18-lex-detect-design.md`
-- Implementation: `docs/plans/2026-03-18-lex-detect-implementation.md`
+- Design: `docs/work/completed/2026-03-18-lex-detect-design.md`
+- Implementation: `docs/work/completed/2026-03-18-lex-detect-implementation.md`
 
 ## Testing
 
-37 specs across 4 spec files.
+40 specs across 6 spec files.
 
 ```bash
 bundle install

data/lib/legion/extensions/detect/runners/task_observer.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Detect
+      module Runners
+        module TaskObserver
+          extend self
+
+          def observe(tasks:, **)
+            return { success: true, alerts: [] } unless tasks.is_a?(Array)
+
+            alerts = generate_alerts(tasks)
+            check_and_publish_failure_patterns(tasks)
+            { success: true, alerts: alerts, task_count: tasks.size }
+          rescue StandardError => e
+            { success: false, reason: :error, message: e.message }
+          end
+
+          private
+
+          def generate_alerts(tasks)
+            failed = tasks.select { |t| t[:status] == 'failed' }
+            return [] if failed.empty?
+
+            failed.group_by { |t| t[:runner_class] }.filter_map do |runner_class, failures|
+              next unless failures.size >= 3
+
+              { runner_class: runner_class, failure_count: failures.size, level: :warning }
+            end
+          end
+
+          def check_and_publish_failure_patterns(tasks)
+            return unless defined?(Legion::Data) && defined?(Legion::Transport)
+
+            runner_failures = tasks.select { |t| t[:status] == 'failed' }
+                                   .group_by { |t| t[:runner_class] }
+
+            runner_failures.each do |runner_class, failures|
+              next unless failures.size >= 3
+
+              gem_name = extract_gem_name(runner_class)
+              backtraces = failures.filter_map { |f| f[:error_backtrace] }.first(5)
+              error_class = failures.first[:error_class] || 'StandardError'
+
+              pattern = build_failure_pattern(gem_name, runner_class, error_class, backtraces, failures.size)
+              publish_failure_pattern(pattern)
+            end
+          rescue StandardError
+            nil
+          end
+
+          def build_failure_pattern(gem_name, runner_class, error_class, backtraces, count)
+            {
+              gem_name:       gem_name,
+              runner_class:   runner_class,
+              error_class:    error_class,
+              backtraces:     backtraces,
+              failure_count:  count,
+              window_minutes: 60
+            }
+          end
+
+          def publish_failure_pattern(pattern)
+            return unless defined?(Legion::Transport::Messages::Dynamic)
+
+            Legion::Transport::Messages::Dynamic.new(
+              function: 'auto_fix',
+              payload:  pattern
+            ).publish
+          rescue StandardError
+            nil
+          end
+
+          def extract_gem_name(runner_class)
+            return nil unless runner_class
+
+            parts = runner_class.to_s.split('::')
+            ext_idx = parts.index('Extensions')
+            return nil unless ext_idx && parts[ext_idx + 1]
+
+            "lex-#{parts[ext_idx + 1].gsub(/([a-z])([A-Z])/, '\1_\2').downcase}"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Detect
-      VERSION = '0.1.2'
+      VERSION = '0.1.3'
     end
   end
 end

data/lib/legion/extensions/detect.rb

@@ -4,6 +4,7 @@ require 'legion/extensions/detect/version'
 require 'legion/extensions/detect/catalog'
 require 'legion/extensions/detect/scanner'
 require 'legion/extensions/detect/installer'
+require_relative 'detect/runners/task_observer'
 
 module Legion
   module Extensions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-detect
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Esity
@@ -32,6 +32,7 @@ files:
 - lib/legion/extensions/detect/catalog.rb
 - lib/legion/extensions/detect/installer.rb
 - lib/legion/extensions/detect/local_migrations/20260319000001_create_detect_results.rb
+- lib/legion/extensions/detect/runners/task_observer.rb
 - lib/legion/extensions/detect/scanner.rb
 - lib/legion/extensions/detect/version.rb
 homepage: https://github.com/LegionIO/lex-detect