lita-interrupt 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b15811f72a7f29073b61d5f8bcdcd7cea23e7ed6
+  data.tar.gz: d67e7c6d51bf17ebd58946b48e94e8c02ab21d34
+SHA512:
+  metadata.gz: fb320ff975a01d83543a859c2c906c470f6b8f8f577e3896213b948ab5e04b714b09f8aefa3d654790da6f87dc72bff3b14c95e12e836f869bea9f94b28c2910
+  data.tar.gz: b265df0952d50b4423fb09eeec78de07b6c3c2f834440ee9f0b37bfb9d920fd646a7ac77cab6bd29548a9b839e05165e6796534ddbf8186cc90d0205d1d2ff66

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+vendor
+/alita
+
+.*.sw[op]
+~*

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 2.0.0
+script: bundle exec rake
+before_install:
+  - gem update --system
+services:
+  - redis-server

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2018 Noel R. Cower. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,91 @@
+# lita-interrupt
+
+[![Build Status](https://travis-ci.org/nilium/lita-interrupt.png?branch=master)](https://travis-ci.org/nilium/lita-interrupt)
+[![Coverage Status](https://coveralls.io/repos/nilium/lita-interrupt/badge.png)](https://coveralls.io/r/nilium/lita-interrupt)
+
+lita-interrupt is a plugin that enables paging of individual services in
+PagerDuty using an alias. It is primarily intended for use in on-call situations
+and is geared towards use in Slack (hasn't been tested on other chat platforms.)
+
+## Installation
+
+Add lita-interrupt to your Lita instance's Gemfile:
+
+``` ruby
+gem "lita-interrupt", :git => 'https://github.com/nilium/lita-interrupt', :branch => 'master'
+```
+
+Currently, there are no published releases, so you have to use the Git
+repository.
+
+## Configuration
+
+lita-interrupt you to set `config.handlers.interrupt.pagerduty_teams` to a hash
+of team names to PagerDuty API tokens. For example:
+
+```ruby
+Lita.configure do |config|
+
+  config.handlers.interrupt.pagerduty_teams = {
+    'team' => 'API-TOKEN',
+  }
+
+end
+```
+
+For now, team names must be a lowercase string.
+
+Users in the `pagerduty_admins` auth group can list services, teams, and create
+and remove aliases.
+
+To override the name required for PagerDuty integrations, you can set the
+`config.handlers.interrupt.integration_name` config value. By default, it is set
+to `lita-interrupt`.
+
+### PagerDuty Integrations
+
+lita-interrupt looks for Events v2 API integrations under PagerDuty services
+with the configured integration name (default: `lita-interrupt`). In order to be
+able to create an alias for a service, you must first add an integration with
+the required name to the service you want to create a notification for.
+
+## Usage
+
+### `call ALIAS [MESSAGE]`
+
+Send a PagerDuty notification to the service identified by the alias. Optionally
+includes a message with the alert.
+
+All alerts attempt to include the caller's name and the channel the notification
+was sent from.
+
+### `int service ls [TEAM [QUERY]]`
+
+List all service IDs configured with a lita-interrupt integration. You can use
+the IDs returned by this to create an alias for a particular team.
+
+Requires `pagerduty_admins` auth.
+
+### `int alias new NAME TEAM SERVICE_ID`
+
+Create an alias with the given name for the team and service ID. Once created,
+the alias can be used to send a PagerDuty alert to the service.
+
+Requires `pagerduty_admins` auth.
+
+### `int alias ls` or `who can I call?`
+
+(Also accepts `who can I call` minus the question mark -- matching is
+case-insensitive.)
+
+List call-able aliases.
+
+### `int alias rm NAME`
+
+Remove an alias with the given name.
+
+Requires `pagerduty_admins` auth.
+
+### `int team ls`
+
+List team IDs.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/interrupt_helper/pager_duty.rb

@@ -0,0 +1,36 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'pager_duty/connection'
+
+module InterruptHelper
+  module PagerDuty
+    def pagerduty(token)
+      @pagerduty_clients ||= Hash.new { |h, k|
+        h[k] = ::PagerDuty::Connection.new(k)
+      }
+      @pagerduty_clients[token]
+    end
+
+    # @return [::Faraday]
+    def events_v2
+      @events_v2_client ||= Faraday.new do |conn|
+        conn.url_prefix = "https://events.pagerduty.com/v2/"
+        conn.use(RaiseNon202)
+        conn.request(:json)
+        conn.response(:json)
+        conn.headers[:accept] = "application/json"
+        conn.adapter(Faraday.default_adapter)
+      end
+    end
+
+    class APIError < RuntimeError; end
+
+    class RaiseNon202 < Faraday::Middleware
+      def call(env)
+        response = @app.call env
+        raise APIError, "bad response code: #{response.status}" unless response.status == 202
+        response
+      end
+    end
+  end
+end

data/lib/lita-interrupt.rb

@@ -0,0 +1,12 @@
+require "lita"
+
+Lita.load_locales Dir[File.expand_path(
+  File.join("..", "..", "locales", "*.yml"), __FILE__
+)]
+
+require "lita/handlers/interrupt"
+
+Lita::Handlers::Interrupt.template_root File.expand_path(
+  File.join("..", "..", "templates"),
+ __FILE__
+)

data/lib/lita/handlers/interrupt.rb

@@ -0,0 +1,309 @@
+require 'json'
+require 'interrupt_helper/pager_duty'
+
+module Lita
+  module Handlers
+    class Interrupt < Handler
+      config :pagerduty_teams, required: true, type: Hash # { lowercase('team') => 'token' }
+      config :integration_name, type: String, default: 'lita-interrupt'.freeze
+
+      # Keys in Redis
+      CALL_ALIASES = 'call_alias'.freeze
+
+      # Constants used by the PagerDuty API
+      EVENTS_API_V2_INBOUND = 'events_api_v2_inbound_integration'.freeze
+
+      include ::InterruptHelper::PagerDuty
+
+      ## ROUTES
+
+      route(
+        /^call\s+(?<alias_id>[^\s]+)(?:\s+(?<message>.+))?\s*$/i,
+        :call_alias,
+        command: true,
+        help: { t('help.call.syntax') => t('help.call.desc') }
+      )
+
+      route(
+        /^int\s+team\s+ls\s*$/i,
+        :list_teams,
+        restrict_to: %w[pagerduty_admins],
+        command: true,
+        help: { t('help.team_ls.syntax') => t('help.team_ls.desc') }
+      )
+
+      route(
+        /^int\s+alias\s+new\s+(?<alias_id>\S+)\s+(?<team_id>\S+)\s+(?<service_id>\S+)\s*$/i,
+        :create_alias,
+        command: true,
+        restrict_to: %w[pagerduty_admins],
+        help: { t('help.alias_new.syntax') => t('help.alias_new.desc') }
+      )
+
+      route(
+        /^int\s+alias\s+rm\s+(?<alias_id>\S+)\s*$/i,
+        :remove_alias,
+        command: true,
+        restrict_to: %w[pagerduty_admins],
+        help: { t('help.alias_rm.syntax') => t('help.alias_rm.desc') }
+      )
+
+      route(
+        /^(int\s+alias\s+ls|who\s+can\s+i\s+call\??)\s*$/i,
+        :list_aliases,
+        command: true,
+        help: { t('help.alias_ls.syntax') => t('help.alias_ls.desc') }
+      )
+
+      route(
+        /^int\s+service\s+ls(\s+(?<team_id>\S+)(\s+(?<query>.+))?)?\s*$/i,
+        :list_services,
+        command: true,
+        restrict_to: %w[pagerduty_admins],
+        help: { t('help.service_ls.syntax') => t('help.service_ls.desc') }
+      )
+
+      ## CALLBACKS
+
+      # @param [Lita::Response] response
+      def call_alias(response)
+        alias_id = response.match_data['alias_id'].downcase
+
+        callee = get_call_alias(alias_id)
+        return response.reply(t('call.no_alias', name: alias_id)) unless callee
+
+        request = gen_call_request(response, callee['integration']['integration_key'])
+        events_v2.post('enqueue', request)
+        response.reply(t('call.ok', name: alias_id))
+
+      rescue APIError => ae
+        log_exception(__callee__, ex)
+        response.reply(t('call.api_error', id: alias_id, message: ae.message))
+      rescue Exception => ex
+        send_exception(response, __callee__, ex)
+      end
+
+      # @param [Lita::Response] response
+      def list_teams(response)
+        names = config.pagerduty_teams.keys
+        if names.empty?
+          response.reply(t('team_ls.no_teams'))
+          return
+        end
+        response.reply(
+          names.sort.map do |team_id|
+            t('team_ls.entry', team_id: team_id)
+          end.join("\n")
+        )
+      rescue Exception => ex
+        send_exception(response, __callee__, ex)
+      end
+
+      # @param [Lita::Response] response
+      def create_alias(response)
+        alias_id = response.match_data['alias_id'].downcase
+        team_id = response.match_data['team_id'].downcase
+        service_id = response.match_data['service_id']
+
+        pd = team(team_id)
+        if pd.nil?
+          response.reply(t('alias_new.no_team', team_id: team_id))
+          return
+        end
+
+        integration = get_events_api_integration(pd, service_id)
+        unless integration
+          return response.reply(t('alias_new.no_integration', service_id: service_id, integration_name: config.integration_name))
+        end
+
+        set_call_alias(alias_id, team_id, service_id, integration)
+        response.reply(t('alias_new.ok', id: alias_id))
+
+      rescue Exception => ex
+        send_exception(response, __callee__, ex)
+      end
+
+      # @param [Lita::Response] response
+      def list_aliases(response)
+        aliases = redis.hgetall(CALL_ALIASES)
+        if aliases.empty?
+          response.reply(t('alias_ls.no_aliases'))
+          return
+        end
+
+        response.reply(
+          aliases.keys.sort.map do |alias_id|
+            obj = MultiJson.load(aliases[alias_id])
+            t(
+              'alias_ls.entry',
+              alias_id: alias_id,
+              service_name: obj['integration']['service']['summary'],
+              team_id: obj['team_id']
+             )
+          end.join("\n")
+        )
+
+      rescue Exception => ex
+        send_exception(response, __callee__, ex)
+      end
+
+      # @param [Lita::Response] response
+      def remove_alias(response)
+        alias_id = response.match_data['alias_id'].downcase
+        if redis.hdel(CALL_ALIASES, alias_id) > 0 then
+          response.reply(t('alias_rm.ok', id: alias_id))
+        else
+          response.reply(t('alias_rm.no_alias', id: alias_id))
+        end
+
+      rescue Exception => ex
+        send_exception(response, __callee__, ex)
+      end
+
+      # @param [Lita::Response] response
+      def list_services(response)
+        team_id = response.match_data['team_id']
+        unless team_id.nil? || team_id.empty?
+          response.reply(list_team_services(team_id, response).join("\n"))
+          return
+        end
+
+        response.reply(
+          config.pagerduty_teams.keys.sort.flat_map do |team_id|
+            [
+              t('service_ls.team', team_id: team_id),
+              *list_team_services(team_id, response)
+            ]
+          end.join("\n")
+        )
+
+      rescue APIError => ae
+        log_exception(__callee__, ex)
+        response.reply(t('call.api_error', id: alias_id, message: ae.message))
+      rescue Exception => ex
+        send_exception(response, __callee__, ex)
+      end
+
+      def list_team_services(team_id, response)
+        pd = team(team_id)
+        if pd.nil?
+          response.reply(t('service_ls.no_team', team_id: team_id))
+          return
+        end
+
+        query = (response.match_data['query'] || '').strip
+        params = {
+          query: query || '',
+          include: %w[integrations]
+        }
+
+        results = pd.get('services', query_params: params)
+
+        # Only list Events API 2-integrated services with suitable integrations
+        services = (results['services'] || []).select do |svc|
+          (svc['integrations'] || []).any? { |i| is_suitable_integration?(i) }
+        end
+        return response.reply(t('service_ls.no_services')) if services.empty?
+
+        services.sort_by { |svc| svc['name'] }.map { |svc|
+          t('service_ls.entry', service_name: svc['name'], service_id: svc['id'])
+        }
+      end
+
+      ## IMPLEMENTATION
+
+      def team(team_id)
+        pagerduty(config.pagerduty_teams[team_id])
+      end
+
+      def send_exception(response, callee, ex)
+        log_exception(callee, ex)
+        response.reply(t('exception', handler: callee, class: ex.class.name, message: ex.message))
+      end
+
+      def log_exception(callee, ex)
+        log.warn("Exception occurred #{ex.class}: #{ex.message}:\n#{ex.backtrace.join("\n")}")
+      end
+
+      def get_room_name(response)
+        room = Lita::Room.find_by_id(response.message.source.room_object.id)
+        room.name || room.mention_name if room
+      end
+
+      def gen_call_request(response, routing_key)
+        # Build summary message sent in the event
+        room_name = get_room_name(response) || ''
+        room_note = room_name.empty? ? '' : " in ##{room_name}"
+        msg = "You've been called by #{response.user.name}#{room_note}."
+
+        sub_msg = (response.match_data['message'] || '').strip
+        unless sub_msg.empty?
+          sub_msg = "#{sub_msg}." unless /\p{Terminal_Punctuation}["']?$/ =~ sub_msg
+          msg = "#{msg}\n#{sub_msg}"
+        end
+
+        source = 'Slack'
+        source = "##{room_name}" unless room_name.empty?
+
+        {
+          routing_key: routing_key,
+          event_action: 'trigger',
+          payload: {
+            summary: msg,
+            source: source,
+            severity: 'critical',
+            component: 'Human',
+            group: 'On-Call',
+            class: 'Notification'
+          }
+        }
+      end
+
+      # @return [Hash] A hash describing the policy alias. If no policy alias is defined, returns nil.
+      def get_call_alias(alias_id)
+        callee_json = redis.hget(CALL_ALIASES, alias_id)
+        return nil if callee_json.nil?
+        MultiJson.load(callee_json)
+      end
+
+      def set_call_alias(alias_id, team_id, service_id, integration)
+        obj = {
+          version: 1,
+          team_id: team_id.to_s,
+          alias_id: alias_id.to_s,
+          service_id: service_id,
+          integration: integration
+        }
+        redis.hset(CALL_ALIASES, alias_id.downcase, MultiJson.dump(obj))
+      end
+
+      def get_events_api_integration(pd, service_id)
+        service = pd.get(
+          "services/#{service_id}",
+          query_params: { include: %w[integrations] }
+        )&.fetch('service')
+        return nil unless service
+        index = service['integrations'].index do |int|
+          int['type'] == EVENTS_API_V2_INBOUND &&
+            int['name'].downcase.gsub(/[_.\s]/, '-') == config.integration_name
+        end
+        index && service['integrations'][index]
+      end
+
+      def required_integration_name
+        @integration_name ||= normalize_name(config.integration_name)
+      end
+
+      def normalize_name(name)
+        name.downcase.gsub(/[\s\._]/, '-')
+      end
+
+      def is_suitable_integration?(integration)
+        integration['type'] == EVENTS_API_V2_INBOUND &&
+          normalize_name(integration['name']) == required_integration_name
+      end
+
+      Lita.register_handler(self)
+    end
+  end
+end

data/lita-interrupt.gemspec

@@ -0,0 +1,30 @@
+Gem::Specification.new do |spec|
+  spec.name          = 'lita-interrupt'
+  spec.version       = '0.1.0'
+  spec.authors       = ['Noel Cower']
+  spec.email         = ['ncower@gmail.com']
+  spec.description   = 'lita-interrupt interrupts a user by assigning them to a new incident in PagerDuty'
+  spec.summary       = 'Interrupts people through the power of PagerDuty'
+  spec.homepage      = 'https://github.com/nilium/lita-interrupt'
+  spec.license       = 'BSD-3-Clause'
+  spec.metadata      = { 'lita_plugin_type' => 'handler' }
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '~> 2.3'
+
+  spec.add_runtime_dependency 'lita', '>= 4.7'
+  spec.add_runtime_dependency 'pager_duty-connection', '~> 1.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'coveralls'
+  spec.add_development_dependency 'pry-byebug'
+  spec.add_development_dependency 'rack-test'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '>= 3.0.0'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'simplecov'
+end

data/locales/en.yml

@@ -0,0 +1,51 @@
+en:
+  lita:
+    handlers:
+      interrupt:
+        team_ls:
+          no_teams: "No teams are configured."
+          entry: "• `%{team_id}`"
+        service_ls:
+          no_services: ":failed: No services found."
+          no_team: ":failed: Team %{team_id} not found."
+          api_error: ":failed: Unable to look up services: %{message}"
+          entry: "• `%{service_id}` - _%{service_name}_"
+          team: "*%{team_id}*"
+        alias_new:
+          no_integration: ":failed: Service `%{service_id}` does not exist or does not have an Events v2 integration named `%{integration_name}`."
+          no_team: ":failed: Team %{team_id} not found."
+          ok: ":success: Alias %{id} created."
+        alias_rm:
+          no_alias: ":failed: Alias %{id} not found."
+          ok: ":success: Alias %{id} deleted."
+        alias_ls:
+          entry: "• `%{alias_id}` → %{service_name} (%{team_id})"
+          no_aliases: "No aliases defined."
+        call:
+          no_alias: ":failed: No alias found with the name %{name}"
+          api_error: ":failed: Unable to call %{id}: %{message}"
+          ok: ":notify: %{name} notified."
+
+        exception: |-
+          :failed: Exception in handler %{handler} (%{class}):
+          %{message}
+
+        help:
+          call:
+            syntax: 'call <NAME> [MESSAGE]'
+            desc: 'Notify the recipient with an optional message via PagerDuty.'
+          team_ls:
+            syntax: 'int team ls'
+            desc: 'List team names.'
+          alias_new:
+            syntax: 'int alias new <NAME> <TEAM> <SERVICE-ID>'
+            desc: 'Create a service call alias (requires the service to have a correctly-named Events v2 integration).'
+          alias_ls:
+            syntax: 'int alias ls | who can i call'
+            desc: 'List aliases.'
+          alias_rm:
+            syntax: 'int alias rm <NAME>'
+            desc: 'Delete an existing service alias.'
+          service_ls:
+            syntax: 'int service ls [TEAM [QUERY]]'
+            desc: 'List services, optionally filtering them by team and with a query (by title).'

data/spec/lita/handlers/interrupt_spec.rb

@@ -0,0 +1,143 @@
+require "spec_helper"
+
+describe Lita::Handlers::Interrupt, lita_handler: true do
+
+  routes = {
+    # :method => ["MESSAGE", ...]
+
+    :call_alias => [
+      'call dev the tirefire seems unhappy today',
+      'call ops we forgot to add more tires',
+      'call dev ',
+      'call ops ',
+      'call dev',
+      'call ops'
+    ],
+
+    :list_teams => [
+      'int team ls ',
+      'int team ls'
+    ],
+
+    :create_alias => [
+      'int alias new alias1 team1 serviceid',
+      'int   alias  new   alias1    team1    serviceid'
+    ],
+
+    :remove_alias => [
+      'int alias rm alias1'
+    ],
+
+    :list_aliases => [
+      'int alias ls ',
+      'int alias ls',
+      'who can I call?',
+      'who can i call?',
+      'WHO CAN  i CALL ' # does it pass the Scott check?
+    ],
+
+    :list_services => [
+      'int service ls',
+      'int service ls ',
+      'int service ls team1',
+      'int service ls team1 query text'
+    ]
+
+  }
+
+  describe "Basic user access" do
+    %i[
+      list_aliases
+      call_alias
+    ].each do |method_name|
+      it "routes basic commands" do
+        routes[method_name].each { |cmd| is_expected.to route_command(cmd).to(method_name) }
+      end
+    end
+  end
+
+  describe "Unauthorized user access" do
+    %i[
+      list_teams
+      create_alias
+      remove_alias
+      list_services
+    ].each do |method_name|
+      it "does not route admin commands" do
+        routes[method_name].each { |cmd| is_expected.not_to route_command(cmd).to(method_name) }
+      end
+    end
+  end
+
+  describe "pagerduty_admins access" do
+    before do
+      robot.auth.add_user_to_group!(user, :pagerduty_admins)
+    end
+
+    routes.each do |method_name, cmds|
+      it "routes all commands" do
+        cmds.each { |cmd| is_expected.to route_command(cmd).to(method_name) }
+      end
+    end
+
+    after do
+      robot.auth.remove_user_from_group!(user, :pagerduty_admins)
+    end
+  end
+
+  let(:success) do
+    pd_client = double
+    events_client = double
+
+    allow(pd_client).to receive(:get).with('services') do
+      # This is not a full response for getting services since there's a lot
+      # more metadata in those.
+      {
+        "limit"    => 100,
+        "offset"   => 0,
+        "total"    => nil,
+        "more"     => false,
+        "services" => [
+          {
+            "id"       => "PT2JFN8",
+            "name"     => "PagerDuty Service",
+            "status"   => "active",
+            "type"     => "service",
+            "self"     => "https://api.pagerduty.com/services/PT2JFN8",
+            "html_url" => "https://teamname.pagerduty.com/services/PT2JFN8",
+
+            "teams" => [
+              {
+                "id"       => "PSODFXI",
+                "type"     => "team_reference",
+                "summary"  => "Team",
+                "self"     => "https://api.pagerduty.com/teams/PSODFXI",
+                "html_url" => "https://teamname.pagerduty.com/teams/PSODFXI",
+              },
+            ],
+
+            "escalation_policy" =>
+              {
+                "id"       => "PEN4ZAY",
+                "type"     => "escalation_policy_reference",
+                "summary"  => "First Responder",
+                "self"     => "https://api.pagerduty.com/escalation_policies/PEN4ZAY",
+                "html_url" => "https://teamname.pagerduty.com/escalation_policies/PEN4ZAY",
+              },
+
+            "integrations" => [
+              {
+                "id"       => "PS1XI4R",
+                "type"     => "generic_email_inbound_integration_reference",
+                "summary"  => "Email",
+                "self"     => "https://api.pagerduty.com/services/PT2JFN8/integrations/PS1XI4R",
+                "html_url" => "https://teamname.pagerduty.com/services/PT2JFN8/integrations/PS1XI4R",
+              },
+            ],
+          }
+        ],
+      }
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require "simplecov"
+require "coveralls"
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new(
+  [
+    SimpleCov::Formatter::HTMLFormatter,
+    Coveralls::SimpleCov::Formatter
+  ])
+SimpleCov.start { add_filter "/spec/" }
+
+require "lita-interrupt"
+require "lita/rspec"
+
+# A compatibility mode is provided for older plugins upgrading from Lita 3. Since this plugin
+# was generated with Lita 4, the compatibility mode should be left disabled.
+Lita.version_3_compatibility_mode = false

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification
+name: lita-interrupt
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Noel Cower
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-07-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lita
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.7'
+- !ruby/object:Gem::Dependency
+  name: pager_duty-connection
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: lita-interrupt interrupts a user by assigning them to a new incident
+  in PagerDuty
+email:
+- ncower@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/interrupt_helper/pager_duty.rb
+- lib/lita-interrupt.rb
+- lib/lita/handlers/interrupt.rb
+- lita-interrupt.gemspec
+- locales/en.yml
+- spec/lita/handlers/interrupt_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/nilium/lita-interrupt
+licenses:
+- BSD-3-Clause
+metadata:
+  lita_plugin_type: handler
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Interrupts people through the power of PagerDuty
+test_files:
+- spec/lita/handlers/interrupt_spec.rb
+- spec/spec_helper.rb