imbi-plugin-pagerduty

PagerDuty plugins for the Imbi platform, distributed as a single Python package (imbi_plugin_pagerduty) shipping three plugin types:

• pagerduty-lifecycle — provisions and maintains a PagerDuty service for each project, routed to the owning team's escalation policy (via the team_escalation_policy_mapping option), and a per-service V3 webhook subscription back to Imbi.
• pagerduty-webhook — receives PagerDuty incident webhooks. v1 records events through the gateway and advertises no custom actions.
• pagerduty-incidents — live-queries PagerDuty for the incidents on a project's service for the project-detail Incidents tab.

The Imbi host discovers these through the imbi.plugins entry points in pyproject.toml. All plugin base classes come from imbi_common.plugins.base.

Development

just setup   # uv sync + pre-commit hooks
just test    # coverage (fails under 85%)
just lint    # ruff, ruff-format, basedpyright

Authentication is a PagerDuty REST API key (auth_type='api_token'), configured as an encrypted plugin credential. PagerDuty is cloud-only, so there is no host-flavor routing.