lex-pagerduty 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d9dd1c37daeb97465f00edc5e171ba4234a224128b97d9038ffc07eff739cb85
+  data.tar.gz: 3ea66c6a537731170c99765c08bf5381ddfa996c3a591b93479774846e97bb24
+SHA512:
+  metadata.gz: 7dd1a597e15f12d9ab884c4b31cb79f0bd63d4774b01d624239420003156a0eaf73cab3638e3bbf019871c70996bd341d57c4140da386610a18ca80d9e08a234
+  data.tar.gz: 6d934d8b865984f0cbd8375c87866cfa328dce8bf572fb8efed00c2287a5e3fc93a76092c84f198de90e789413a5c746bda07a29a74b8294f750a1caf6050abd

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,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,53 @@
+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: 10
+
+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,12 @@
+# Changelog
+
+## [0.2.1] - 2026-03-22
+
+### Changed
+- Add legion-cache, legion-crypt, legion-data, legion-json, legion-logging, legion-settings, legion-transport as runtime dependencies
+- Update spec_helper with real sub-gem helper stubs
+
+## [0.2.0] - 2026-03-13
+
+### Added
+- Initial release

data/CLAUDE.md

@@ -0,0 +1,72 @@
+# lex-pagerduty: PagerDuty Integration for LegionIO
+
+**Repository Level 3 Documentation**
+- **Parent**: `/Users/miverso2/rubymine/legion/extensions-other/CLAUDE.md`
+- **Grandparent**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+
+## Purpose
+
+Legion Extension that connects LegionIO to PagerDuty via the REST API v2. Provides runners for managing incidents, services, escalation policies, schedules, users, teams, on-calls, priorities, maintenance windows, log entries, notifications, tags, abilities, and vendors.
+
+**GitHub**: https://github.com/LegionIO/lex-pagerduty
+**License**: MIT
+**Version**: 0.2.0
+
+## Architecture
+
+```
+Legion::Extensions::Pagerduty
+├── Runners/
+│   ├── Incidents            # Incident lifecycle (create, ack, resolve, merge, snooze, notes, alerts)
+│   ├── Services             # Service CRUD + integrations
+│   ├── EscalationPolicies   # Escalation policy CRUD
+│   ├── Schedules            # Schedule CRUD + overrides + on-call users
+│   ├── Users                # User CRUD + contact methods + notification rules
+│   ├── Teams                # Team CRUD + member management
+│   ├── OnCalls              # On-call listing with schedule/policy filters
+│   ├── Priorities           # Priority listing
+│   ├── MaintenanceWindows   # Maintenance window CRUD
+│   ├── LogEntries           # Log entry queries
+│   ├── Notifications        # Notification listing
+│   ├── Tags                 # Tag CRUD + entity assignment
+│   ├── Abilities            # Account ability queries
+│   └── Vendors              # Vendor listing
+├── Helpers/
+│   └── Client               # Faraday connection builder (PagerDuty REST API v2)
+└── Client                   # Standalone client class (includes all runners)
+```
+
+## Key Files
+
+| Path | Purpose |
+|------|---------|
+| `lib/legion/extensions/pagerduty.rb` | Entry point, loads all runners |
+| `lib/legion/extensions/pagerduty/client.rb` | Standalone client (initialize with token:) |
+| `lib/legion/extensions/pagerduty/helpers/client.rb` | Faraday builder for PagerDuty API |
+| `lib/legion/extensions/pagerduty/runners/` | All runners |
+
+## API Authentication
+
+PagerDuty uses token-based auth: `Authorization: Token token=YOUR_TOKEN`
+
+Mutating incident operations require a `From` header with the user's email address.
+
+## Dependencies
+
+| Gem | Purpose |
+|-----|---------|
+| `faraday` (>= 2.0) | HTTP client for PagerDuty REST API v2 |
+
+## Development
+
+37 specs total.
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+---
+
+**Maintained By**: Matthew Iverson (@Esity)

data/Dockerfile

@@ -0,0 +1,6 @@
+FROM legionio/legion
+
+COPY . /usr/src/app/lex-pagerduty
+
+WORKDIR /usr/src/app/lex-pagerduty
+RUN bundle install

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/Gemfile.lock

@@ -0,0 +1,171 @@
+PATH
+  remote: .
+  specs:
+    lex-pagerduty (0.2.1)
+      faraday (>= 2.0)
+      legion-cache (>= 1.3.11)
+      legion-crypt (>= 1.4.9)
+      legion-data (>= 1.4.17)
+      legion-json (>= 1.2.1)
+      legion-logging (>= 1.3.2)
+      legion-settings (>= 1.3.14)
+      legion-transport (>= 1.3.9)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    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)
+    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)
+    connection_pool (2.5.5)
+    dalli (5.0.2)
+      logger
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    ed25519 (1.4.0)
+    faraday (2.14.1)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    json (2.19.1)
+    json-schema (6.2.0)
+      addressable (~> 2.8)
+      bigdecimal (>= 3.1, < 5)
+    json_pure (2.8.1)
+    jwt (3.1.2)
+      base64
+    language_server-protocol (3.17.0.5)
+    legion-cache (1.3.11)
+      connection_pool (>= 2.4)
+      dalli (>= 3.0)
+      legion-logging (>= 1.2.8)
+      legion-settings (>= 1.3.12)
+      redis (>= 5.0)
+    legion-crypt (1.4.9)
+      ed25519 (~> 1.3)
+      jwt (>= 2.7)
+      vault (>= 0.17)
+    legion-data (1.4.17)
+      legion-logging (>= 1.2.8)
+      legion-settings (>= 1.3.12)
+      sequel (>= 5.70)
+      sqlite3 (>= 2.0)
+    legion-json (1.2.1)
+      json_pure
+      multi_json
+    legion-logging (1.3.2)
+      logger
+      rainbow (~> 3)
+    legion-settings (1.3.14)
+      legion-json (>= 1.2.0)
+    legion-transport (1.3.9)
+      bunny (>= 2.23)
+      concurrent-ruby (>= 1.2)
+      legion-json (>= 1.2.0)
+      legion-settings (>= 1.3.12)
+      logger
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    mcp (0.8.0)
+      json-schema (>= 4.1)
+    mini_portile2 (2.8.9)
+    multi_json (1.19.1)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    net-http-persistent (4.0.8)
+      connection_pool (>= 2.2.4, < 4)
+    parallel (1.27.0)
+    parser (3.3.10.2)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    public_suffix (7.0.5)
+    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.28.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.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rspec_junit_formatter (0.6.0)
+      rspec-core (>= 2, < 4, != 2.12.0)
+    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.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      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)
+    sequel (5.102.0)
+      bigdecimal
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    sorted_set (1.1.0)
+      rbtree
+    sqlite3 (2.9.2)
+      mini_portile2 (~> 2.8.0)
+    sqlite3 (2.9.2-arm64-darwin)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    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
+  lex-pagerduty!
+  rake
+  rspec
+  rspec_junit_formatter
+  rubocop
+  simplecov
+
+BUNDLED WITH
+   2.6.9

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 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,70 @@
+# lex-pagerduty
+
+PagerDuty integration for [LegionIO](https://github.com/LegionIO/LegionIO). Manage incidents, services, escalation policies, schedules, users, teams, on-calls, priorities, maintenance windows, log entries, notifications, tags, abilities, and vendors via the PagerDuty REST API v2.
+
+## Installation
+
+```bash
+gem install lex-pagerduty
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'lex-pagerduty'
+```
+
+## Standalone Usage
+
+```ruby
+require 'legion/extensions/pagerduty'
+
+client = Legion::Extensions::Pagerduty::Client.new(token: 'your-api-token')
+
+# Incidents
+client.list_incidents(statuses: ['triggered', 'acknowledged'])
+client.create_incident(title: 'Server down', service_id: 'PSVC123')
+client.update_incident(id: 'PINC456', from: 'user@example.com', status: 'acknowledged')
+client.snooze_incident(id: 'PINC456', from: 'user@example.com', duration: 3600)
+
+# Services
+client.list_services
+client.create_service(name: 'My App', escalation_policy_id: 'PEP789')
+
+# Schedules
+client.list_schedules
+client.list_on_call_users(id: 'PSCH123')
+
+# Users & Teams
+client.list_users(query: 'john')
+client.add_member(team_id: 'PTEAM1', user_id: 'PUSER1')
+```
+
+## Runners
+
+| Runner | Operations |
+|--------|-----------|
+| Incidents | List, create, get, update, merge, snooze, notes, alerts |
+| Services | List, create, get, update, delete, integrations |
+| EscalationPolicies | List, create, get, update, delete |
+| Schedules | List, create, get, update, delete, overrides, on-call users |
+| Users | List, create, get, update, delete, contact methods, notification rules |
+| Teams | List, create, get, update, delete, add/remove members |
+| OnCalls | List on-call entries |
+| Priorities | List priorities |
+| MaintenanceWindows | List, create, get, update, delete |
+| LogEntries | List, get |
+| Notifications | List |
+| Tags | List, create, get, delete, assign/remove from entities |
+| Abilities | List, test |
+| Vendors | List, get |
+
+## Requirements
+
+- Ruby >= 3.4
+- PagerDuty account with API token
+- [LegionIO](https://github.com/LegionIO/LegionIO) framework (optional — standalone Client works without it)
+
+## License
+
+MIT

data/lex-pagerduty.gemspec

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative 'lib/legion/extensions/pagerduty/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'lex-pagerduty'
+  spec.version       = Legion::Extensions::Pagerduty::VERSION
+  spec.authors       = ['Esity']
+  spec.email         = ['matthewdiverson@gmail.com']
+
+  spec.summary       = 'LEX Pagerduty'
+  spec.description   = 'Connects LegionIO to PagerDuty'
+  spec.homepage      = 'https://github.com/LegionIO/lex-pagerduty'
+  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-pagerduty'
+  spec.metadata['documentation_uri'] = 'https://github.com/LegionIO/lex-pagerduty'
+  spec.metadata['changelog_uri'] = 'https://github.com/LegionIO/lex-pagerduty'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/LegionIO/lex-pagerduty/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 'faraday', '>= 2.0'
+  spec.add_dependency 'legion-cache', '>= 1.3.11'
+  spec.add_dependency 'legion-crypt', '>= 1.4.9'
+  spec.add_dependency 'legion-data', '>= 1.4.17'
+  spec.add_dependency 'legion-json', '>= 1.2.1'
+  spec.add_dependency 'legion-logging', '>= 1.3.2'
+  spec.add_dependency 'legion-settings', '>= 1.3.14'
+  spec.add_dependency 'legion-transport', '>= 1.3.9'
+end

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/pagerduty/helpers/client'
+require 'legion/extensions/pagerduty/runners/incidents'
+require 'legion/extensions/pagerduty/runners/services'
+require 'legion/extensions/pagerduty/runners/escalation_policies'
+require 'legion/extensions/pagerduty/runners/schedules'
+require 'legion/extensions/pagerduty/runners/users'
+require 'legion/extensions/pagerduty/runners/teams'
+require 'legion/extensions/pagerduty/runners/on_calls'
+require 'legion/extensions/pagerduty/runners/priorities'
+require 'legion/extensions/pagerduty/runners/maintenance_windows'
+require 'legion/extensions/pagerduty/runners/log_entries'
+require 'legion/extensions/pagerduty/runners/notifications'
+require 'legion/extensions/pagerduty/runners/tags'
+require 'legion/extensions/pagerduty/runners/abilities'
+require 'legion/extensions/pagerduty/runners/vendors'
+
+module Legion
+  module Extensions
+    module Pagerduty
+      class Client
+        include Helpers::Client
+        include Runners::Incidents
+        include Runners::Services
+        include Runners::EscalationPolicies
+        include Runners::Schedules
+        include Runners::Users
+        include Runners::Teams
+        include Runners::OnCalls
+        include Runners::Priorities
+        include Runners::MaintenanceWindows
+        include Runners::LogEntries
+        include Runners::Notifications
+        include Runners::Tags
+        include Runners::Abilities
+        include Runners::Vendors
+
+        attr_reader :opts
+
+        def initialize(token: nil, api_url: 'https://api.pagerduty.com', **extra)
+          @opts = { token: token, api_url: api_url, **extra }
+        end
+
+        def connection(**override)
+          super(**@opts.merge(override))
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/pagerduty/helpers/client.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'faraday'
+
+module Legion
+  module Extensions
+    module Pagerduty
+      module Helpers
+        module Client
+          def connection(api_url: 'https://api.pagerduty.com', token: nil, **_opts)
+            Faraday.new(url: api_url) do |conn|
+              conn.request :json
+              conn.response :json, content_type: /\bjson$/
+              conn.headers['Content-Type'] = 'application/json'
+              conn.headers['Authorization'] = "Token token=#{token}" if token
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/pagerduty/runners/abilities.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/pagerduty/helpers/client'
+
+module Legion
+  module Extensions
+    module Pagerduty
+      module Runners
+        module Abilities
+          include Legion::Extensions::Pagerduty::Helpers::Client
+
+          def list_abilities(**)
+            response = connection(**).get('/abilities')
+            { result: response.body }
+          end
+
+          def test_ability(ability:, **)
+            response = connection(**).get("/abilities/#{ability}")
+            { result: response.status == 204 }
+          end
+
+          include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
+                                                      Legion::Extensions::Helpers.const_defined?(:Lex)
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/pagerduty/runners/escalation_policies.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/pagerduty/helpers/client'
+
+module Legion
+  module Extensions
+    module Pagerduty
+      module Runners
+        module EscalationPolicies
+          include Legion::Extensions::Pagerduty::Helpers::Client
+
+          def list_escalation_policies(query: nil, per_page: 25, page: 0, **)
+            params = { limit: per_page, offset: page * per_page }
+            params[:query] = query if query
+            response = connection(**).get('/escalation_policies', params)
+            { result: response.body }
+          end
+
+          def get_escalation_policy(id:, **)
+            response = connection(**).get("/escalation_policies/#{id}")
+            { result: response.body }
+          end
+
+          def create_escalation_policy(name:, escalation_rules:, description: nil, repeat_enabled: false,
+                                       num_loops: 0, **)
+            payload = {
+              escalation_policy: {
+                type:             'escalation_policy',
+                name:             name,
+                escalation_rules: escalation_rules,
+                repeat_enabled:   repeat_enabled,
+                num_loops:        num_loops
+              }
+            }
+            payload[:escalation_policy][:description] = description if description
+            response = connection(**).post('/escalation_policies', payload)
+            { result: response.body }
+          end
+
+          def update_escalation_policy(id:, **opts)
+            payload = opts.slice(:name, :description, :escalation_rules, :repeat_enabled, :num_loops)
+            response = connection(**opts).put("/escalation_policies/#{id}",
+                                              { escalation_policy: { type: 'escalation_policy', **payload } })
+            { result: response.body }
+          end
+
+          def delete_escalation_policy(id:, **)
+            response = connection(**).delete("/escalation_policies/#{id}")
+            { result: response.status == 204 }
+          end
+
+          include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
+                                                      Legion::Extensions::Helpers.const_defined?(:Lex)
+        end
+      end
+    end
+  end
+end