lex-detect 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0f221abbf1751de26290f2d11137ec31338bb77dfb64b033ce09ebffbcd73d9d
+  data.tar.gz: fac9bfec6e9275b5b48d8d1e253edf98e1fa504b48f90300a44604fe79bd5cc9
+SHA512:
+  metadata.gz: '0259374ea1f54906333dba2cbb9de76c6c1081a1e24082956a86b055cfdaa942a442c8d48eb3f49f373276c91bf2901e21720b669205ddc90a3fe97001976d41'
+  data.tar.gz: b6a5d1afa9da7d4f7a6feecd24e49ae2bced0123e79df54d368fa6f1e610189a72e8991866768ff0f4881bd056404b6208318764fb38e66bf57ab2f30835277e

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,13 @@
+/.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,56 @@
+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/ParameterLists:
+  Max: 8
+
+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
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## [0.1.1] - 2026-03-18
+
+### Changed
+- Switch CI to reusable workflows from LegionIO/.github
+
+## [0.1.0] - 2026-03-18
+
+### Added
+- Detection catalog with 20 rules covering AI providers, communication, productivity, developer tools, HashiCorp, infrastructure, and operations
+- Scanner module: probes macOS apps, Homebrew formulas/casks, environment variables, TCP ports, and config files
+- Installer module: `Gem.install` wrapper with dry_run support
+- Public API: `scan`, `missing`, `install_missing!`, `catalog`
+- Parallel port scanning with 1-second connect timeout
+- Zero runtime dependencies

data/CLAUDE.md

@@ -0,0 +1,67 @@
+# lex-detect: Environment-Aware Extension Discovery
+
+**Repository Level 3 Documentation**
+- **Parent (Level 2)**: `/Users/miverso2/rubymine/legion/extensions/CLAUDE.md`
+- **Parent (Level 1)**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+
+## Purpose
+
+Legion Extension that scans the local environment and recommends which `lex-*` extensions to install. Detects macOS apps, Homebrew formulas/casks, environment variables, open TCP ports, and config files, then maps them to recommended extensions via a declarative catalog.
+
+**GitHub**: https://github.com/LegionIO/lex-detect
+**License**: MIT
+**Version**: 0.1.0
+
+## Architecture
+
+```
+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
+└── 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.
+
+- `data_required? false` — no database needed
+- `remote_invocable? false` — no AMQP queue creation
+
+## Signal Types
+
+| Type | Source | Platform |
+|------|--------|----------|
+| `:app` | `/Applications/*.app` | macOS |
+| `:brew_formula` | `brew list --formula` | macOS/Linux |
+| `:brew_cask` | `brew list --cask` | macOS |
+| `:env` | `ENV.keys` | all |
+| `:port` | TCP connect probe (1s timeout) | all |
+| `:file` | `File.exist?` with `~` expansion | all |
+
+## Public API
+
+```ruby
+Legion::Extensions::Detect.scan             # full scan results
+Legion::Extensions::Detect.missing          # uninstalled gem names
+Legion::Extensions::Detect.install_missing! # install missing gems
+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`
+
+## Testing
+
+37 specs across 4 spec files.
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+---
+
+**Maintained By**: Matthew Iverson (@Esity)

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 @@
+MIT License
+
+Copyright (c) 2026 LegionIO
+
+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,65 @@
+# lex-detect
+
+Environment-aware extension discovery for [LegionIO](https://github.com/LegionIO).
+
+Scans your local environment (macOS apps, Homebrew packages, environment variables, open ports, config files) and recommends which `lex-*` extensions to install.
+
+## Installation
+
+```bash
+gem install lex-detect
+```
+
+## Usage
+
+```ruby
+require 'legion/extensions/detect'
+
+# Full scan — returns array of detection results
+results = Legion::Extensions::Detect.scan
+# => [{ name: 'Claude', extensions: ['lex-claude'],
+#        matched_signals: ['app:Claude.app'], installed: { 'lex-claude' => true } }, ...]
+
+# Just the missing gems
+missing = Legion::Extensions::Detect.missing
+# => ['lex-slack', 'lex-todoist']
+
+# Install all missing
+Legion::Extensions::Detect.install_missing!
+# => { installed: ['lex-slack', 'lex-todoist'], failed: [] }
+
+# Dry run
+Legion::Extensions::Detect.install_missing!(dry_run: true)
+
+# View the catalog
+Legion::Extensions::Detect.catalog
+```
+
+## Detection Catalog
+
+| Name | Extensions | Signal Types |
+|------|-----------|-------------|
+| Claude | lex-claude | app, brew_cask, env |
+| OpenAI | lex-openai | app, brew_cask, env |
+| Ollama | lex-openai | brew_formula, port |
+| Slack | lex-slack | app, brew_cask |
+| Microsoft Teams | lex-microsoft_teams | app, brew_cask |
+| Todoist | lex-todoist | app, brew_cask |
+| GitHub | lex-github | app, brew_formula, brew_cask, env |
+| Consul | lex-consul | brew_formula, port |
+| Vault | lex-vault | brew_formula, port, env |
+| Nomad | lex-nomad | brew_formula, port |
+| Terraform | lex-tfe | brew_formula, file |
+| RabbitMQ | legion-transport | brew_formula, port, env |
+| Redis | lex-redis, legion-cache | brew_formula, port, env |
+| Memcached | legion-cache | brew_formula, port |
+| PostgreSQL | legion-data | brew_formula, port, env |
+| MySQL | legion-data | brew_formula, port |
+| Chef | lex-chef | app, file |
+| S3 / AWS | lex-s3 | brew_formula, env, file |
+| Elasticsearch | lex-elasticsearch | brew_formula, port |
+| InfluxDB | lex-influxdb | brew_formula, port |
+
+## License
+
+MIT

data/lex-detect.gemspec

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative 'lib/legion/extensions/detect/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'lex-detect'
+  spec.version       = Legion::Extensions::Detect::VERSION
+  spec.authors       = ['Esity']
+  spec.email         = ['matthewdiverson@gmail.com']
+
+  spec.summary       = 'LEX Detect'
+  spec.description   = 'Environment-aware extension discovery for LegionIO'
+  spec.homepage      = 'https://github.com/LegionIO/lex-detect'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.4'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/LegionIO/lex-detect'
+  spec.metadata['documentation_uri'] = 'https://github.com/LegionIO/lex-detect'
+  spec.metadata['changelog_uri'] = 'https://github.com/LegionIO/lex-detect'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/LegionIO/lex-detect/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']
+end

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

@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Detect
+      CATALOG = [
+        # AI Providers
+        {
+          name:       'Claude',
+          extensions: ['lex-claude'],
+          signals:    [
+            { type: :app, match: 'Claude.app' },
+            { type: :brew_cask, match: 'claude' },
+            { type: :brew_cask, match: 'claude-code' },
+            { type: :brew_formula, match: 'claude-code' },
+            { type: :env, match: 'ANTHROPIC_API_KEY' }
+          ]
+        },
+        {
+          name:       'OpenAI',
+          extensions: ['lex-openai'],
+          signals:    [
+            { type: :app, match: 'ChatGPT.app' },
+            { type: :brew_cask, match: 'chatgpt' },
+            { type: :brew_cask, match: 'codex' },
+            { type: :env, match: 'OPENAI_API_KEY' }
+          ]
+        },
+        {
+          name:       'Ollama',
+          extensions: ['lex-openai'],
+          signals:    [
+            { type: :brew_formula, match: 'ollama' },
+            { type: :port, match: 11_434 }
+          ]
+        },
+
+        # Communication
+        {
+          name:       'Slack',
+          extensions: ['lex-slack'],
+          signals:    [
+            { type: :app, match: 'Slack.app' },
+            { type: :brew_cask, match: 'slack' }
+          ]
+        },
+        {
+          name:       'Microsoft Teams',
+          extensions: ['lex-microsoft_teams'],
+          signals:    [
+            { type: :app, match: 'Microsoft Teams.app' },
+            { type: :brew_cask, match: 'microsoft-teams' }
+          ]
+        },
+
+        # Productivity
+        {
+          name:       'Todoist',
+          extensions: ['lex-todoist'],
+          signals:    [
+            { type: :app, match: 'Todoist.app' },
+            { type: :brew_cask, match: 'todoist' },
+            { type: :brew_cask, match: 'todoist-app' }
+          ]
+        },
+
+        # Developer Tools
+        {
+          name:       'GitHub',
+          extensions: ['lex-github'],
+          signals:    [
+            { type: :app, match: 'GitHub Desktop.app' },
+            { type: :brew_formula, match: 'gh' },
+            { type: :brew_cask, match: 'github' },
+            { type: :env, match: 'GITHUB_TOKEN' }
+          ]
+        },
+
+        # HashiCorp
+        {
+          name:       'Consul',
+          extensions: ['lex-consul'],
+          signals:    [
+            { type: :brew_formula, match: /^consul/ },
+            { type: :port, match: 8500 }
+          ]
+        },
+        {
+          name:       'Vault',
+          extensions: ['lex-vault'],
+          signals:    [
+            { type: :brew_formula, match: /^vault/ },
+            { type: :port, match: 8200 },
+            { type: :env, match: 'VAULT_ADDR' }
+          ]
+        },
+        {
+          name:       'Nomad',
+          extensions: ['lex-nomad'],
+          signals:    [
+            { type: :brew_formula, match: /^nomad/ },
+            { type: :port, match: 4646 }
+          ]
+        },
+        {
+          name:       'Terraform',
+          extensions: ['lex-tfe'],
+          signals:    [
+            { type: :brew_formula, match: 'terraform' },
+            { type: :brew_formula, match: 'tfenv' },
+            { type: :file, match: '~/.terraform.d/credentials.tfrc.json' }
+          ]
+        },
+
+        # Infrastructure
+        {
+          name:       'RabbitMQ',
+          extensions: ['legion-transport'],
+          signals:    [
+            { type: :brew_formula, match: 'rabbitmq' },
+            { type: :port, match: 5672 },
+            { type: :env, match: 'AMQP_URL' }
+          ]
+        },
+        {
+          name:       'Redis',
+          extensions: %w[lex-redis legion-cache],
+          signals:    [
+            { type: :brew_formula, match: 'redis' },
+            { type: :port, match: 6379 },
+            { type: :env, match: 'REDIS_URL' }
+          ]
+        },
+        {
+          name:       'Memcached',
+          extensions: ['legion-cache'],
+          signals:    [
+            { type: :brew_formula, match: 'memcached' },
+            { type: :port, match: 11_211 }
+          ]
+        },
+        {
+          name:       'PostgreSQL',
+          extensions: ['legion-data'],
+          signals:    [
+            { type: :brew_formula, match: /^postgresql/ },
+            { type: :port, match: 5432 },
+            { type: :env, match: 'DATABASE_URL' }
+          ]
+        },
+        {
+          name:       'MySQL',
+          extensions: ['legion-data'],
+          signals:    [
+            { type: :brew_formula, match: /^mysql/ },
+            { type: :port, match: 3306 }
+          ]
+        },
+
+        # Operations
+        {
+          name:       'Chef',
+          extensions: ['lex-chef'],
+          signals:    [
+            { type: :app, match: 'Chef Workstation App.app' },
+            { type: :file, match: '~/.chef/config.rb' },
+            { type: :file, match: '~/.chef/credentials' }
+          ]
+        },
+        {
+          name:       'S3 / AWS',
+          extensions: ['lex-s3'],
+          signals:    [
+            { type: :brew_formula, match: 'awscli' },
+            { type: :env, match: 'AWS_ACCESS_KEY_ID' },
+            { type: :file, match: '~/.aws/credentials' }
+          ]
+        },
+        {
+          name:       'Elasticsearch',
+          extensions: ['lex-elasticsearch'],
+          signals:    [
+            { type: :brew_formula, match: 'elasticsearch' },
+            { type: :brew_formula, match: 'opensearch' },
+            { type: :port, match: 9200 }
+          ]
+        },
+        {
+          name:       'InfluxDB',
+          extensions: ['lex-influxdb'],
+          signals:    [
+            { type: :brew_formula, match: 'influxdb' },
+            { type: :port, match: 8086 }
+          ]
+        }
+      ].freeze
+
+      SIGNAL_TYPES = %i[app brew_formula brew_cask env port file].freeze
+
+      SCAN_PORTS = [5672, 6379, 11_211, 8200, 5432, 3306, 8500, 4646, 9200, 8086, 11_434].freeze
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Detect
+      module Installer
+        class << self
+          def install(gem_names, dry_run: false)
+            return { installed: gem_names, failed: [] } if dry_run
+
+            installed = []
+            failed = []
+
+            gem_names.each do |name|
+              Gem.install(name)
+              installed << name
+            rescue StandardError => e
+              failed << { name: name, error: e.message }
+            end
+
+            { installed: installed, failed: failed }
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require 'socket'
+
+module Legion
+  module Extensions
+    module Detect
+      module Scanner
+        class << self
+          def scan
+            env = gather_environment
+            CATALOG.each_with_object([]) do |rule, results|
+              matched_signals = rule[:signals].select { |s| signal_present?(s, env) }
+              next if matched_signals.empty?
+
+              results << {
+                name:            rule[:name],
+                extensions:      rule[:extensions],
+                matched_signals: matched_signals.map { |s| "#{s[:type]}:#{s[:match]}" },
+                installed:       rule[:extensions].to_h { |e| [e, gem_installed?(e)] }
+              }
+            end
+          end
+
+          def gather_environment
+            {
+              apps:          scan_applications,
+              brew_formulas: scan_brew_formulas,
+              brew_casks:    scan_brew_casks,
+              env_vars:      ENV.keys,
+              ports:         scan_ports,
+              files:         nil
+            }
+          end
+
+          def reset!
+            @environment = nil
+          end
+
+          private
+
+          def scan_applications
+            Dir.glob('/Applications/*.app').map { |p| File.basename(p) }
+          rescue StandardError
+            []
+          end
+
+          def scan_brew_formulas
+            `brew list --formula -1 2>/dev/null`.split("\n")
+          rescue StandardError
+            []
+          end
+
+          def scan_brew_casks
+            `brew list --cask -1 2>/dev/null`.split("\n")
+          rescue StandardError
+            []
+          end
+
+          def scan_ports
+            threads = SCAN_PORTS.map do |port|
+              Thread.new(port) do |p|
+                Socket.tcp('127.0.0.1', p, connect_timeout: 1) { true }
+              rescue StandardError
+                false
+              end
+            end
+
+            SCAN_PORTS.zip(threads.map(&:value)).select { |_port, open| open }.map(&:first)
+          end
+
+          def signal_present?(signal, env)
+            case signal[:type]
+            when :app          then env[:apps].any? { |a| match_value?(a, signal[:match]) }
+            when :brew_formula then env[:brew_formulas].any? { |f| match_value?(f, signal[:match]) }
+            when :brew_cask    then env[:brew_casks].any? { |c| match_value?(c, signal[:match]) }
+            when :env          then env[:env_vars].include?(signal[:match])
+            when :port         then env[:ports].include?(signal[:match])
+            when :file         then File.exist?(File.expand_path(signal[:match]))
+            else false
+            end
+          end
+
+          def match_value?(value, pattern)
+            pattern.is_a?(Regexp) ? value.match?(pattern) : value == pattern
+          end
+
+          def gem_installed?(name)
+            Gem::Specification.find_by_name(name)
+            true
+          rescue Gem::MissingSpecError
+            false
+          end
+        end
+      end
+    end
+  end
+end

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

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

data/lib/legion/extensions/detect.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/detect/version'
+require 'legion/extensions/detect/catalog'
+require 'legion/extensions/detect/scanner'
+require 'legion/extensions/detect/installer'
+
+module Legion
+  module Extensions
+    module Detect
+      extend Legion::Extensions::Core if Legion::Extensions.const_defined?(:Core)
+
+      class << self
+        def data_required?
+          false
+        end
+
+        def remote_invocable?
+          false
+        end
+
+        def scan
+          Scanner.scan
+        end
+
+        def missing
+          results = scan
+          results.each_with_object([]) do |detection, gems|
+            detection[:installed].each do |gem_name, installed|
+              gems << gem_name unless installed || gems.include?(gem_name)
+            end
+          end
+        end
+
+        def install_missing!(dry_run: false)
+          Installer.install(missing, dry_run: dry_run)
+        end
+
+        def catalog
+          CATALOG
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: lex-detect
+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: []
+description: Environment-aware extension discovery for LegionIO
+email:
+- matthewdiverson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CLAUDE.md
+- Gemfile
+- LICENSE
+- README.md
+- lex-detect.gemspec
+- lib/legion/extensions/detect.rb
+- lib/legion/extensions/detect/catalog.rb
+- lib/legion/extensions/detect/installer.rb
+- lib/legion/extensions/detect/scanner.rb
+- lib/legion/extensions/detect/version.rb
+homepage: https://github.com/LegionIO/lex-detect
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/LegionIO/lex-detect
+  source_code_uri: https://github.com/LegionIO/lex-detect
+  documentation_uri: https://github.com/LegionIO/lex-detect
+  changelog_uri: https://github.com/LegionIO/lex-detect
+  bug_tracker_uri: https://github.com/LegionIO/lex-detect/issues
+  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: LEX Detect
+test_files: []