Modules
Parapet provides telemetry foundations and safety rails for Phoenix SaaS teams.
Provides flap protection by short-circuiting automated runbook execution if it loops excessively.
Transaction seam for durable logical-action claims under contention.
Oban worker for executing automated runbook mitigations. Safely delegates back to the Operator API under a system identity.
Registry for dynamic capabilities provided by activated adapters. This module serves as the Phase 7 named recovery contract.
API for emitting deployment markers as telemetry events.
Behaviour for incident escalation adapters.
Oban worker for durable asynchronous dispatch of escalations.
Public API boundary for Spine schemas. Enforces a boundary that prevents high-volume telemetry from writing directly to the durable Ecto database.
Optional Oban worker for scheduling Parapet evidence archival.
Archives old, resolved incidents to a JSONL file and deletes them from the primary database.
Generates automated markdown retrospectives from an incident and its timeline.
Behaviour for Parapet ecosystem integration adapters.
Parapet integration for the Accrue billing library. Listens to Accrue telemetry events and translates them into standard Parapet billing journey metrics.
Parapet integration for the Chimeway email library. Listens to Chimeway telemetry events and translates them into the Phase 4 Parapet delivery telemetry contract.
Parapet integration for the Mailglass email library. Listens to Mailglass telemetry events and translates them into the Phase 4 Parapet delivery telemetry contract.
Parapet integration for the Rindle media processing library. Listens to Rindle telemetry events and translates them into the Phase 4 Parapet async telemetry contract.
Telemetry adapter for buffering Rulestead flag changes natively inside Parapet's spine.
Parapet integration for the Scoria AI library. Listens to Scoria telemetry events and translates them into Parapet metrics while stripping high-cardinality metadata and creating incidents for severe errors.
Parapet integration for the Sigra authentication library. Listens to Sigra telemetry events and translates them into standard Parapet login and signup journey metrics.
Parapet integration for the Threadline audit library. Maps audit data between Threadline and Parapet.
A read-only Prometheus HTTP API proxy using Req to allow external agents
to retrieve predefined time-series metrics.
Core MCP server tool execution and routing. Provides a controlled, read-only interface for external AI agents to investigate incidents safely.
Prometheus metric definitions for Accrue.
Shared Telemetry.Metrics catalog and PromQL selector helpers for Phase 5 async and delivery reliability slices.
Defines Prometheus distributions for Ecto queries.
An ETS-backed store for holding the latest trace ID associated with a metric and its tags. This allows Prometheus formatters to quickly fetch the recent trace exemplar.
Attaches to Telemetry events to capture trace_ids and store them as exemplars.
Defines Prometheus counters and distributions for HTTP requests.
Defines Prometheus distributions and counters for Oban jobs conditionally.
Defines Prometheus distributions and counters for synthetic probes.
A custom formatter that wraps standard Prometheus output and injects OpenMetrics exemplars for trace_ids from the ExemplarStore.
Prometheus metric definitions for Rulestead events.
Defines Prometheus counters and distributions for Scoria evaluation metrics.
Prometheus metric definitions for Sigra.
Compile-time validation for telemetry metrics to prevent TSDB cardinality explosion.
Behaviour for incident notification adapters.
Oban worker for durable asynchronous dispatch of notifications.
Slack adapter for Parapet notifications. Sends rich Block Kit messages for incident updates.
MS Teams adapter for Parapet notifications. Sends rich Adaptive Cards for incident updates.
Phoenix-free public boundary for the in-app Operator UI. Provides queue/detail queries and audited command entrypoints for incident mutations.
Shared action payload contract for operator commands. Ensures that every mutating operator command provides mandatory audit metadata (actor, reason, correlation_id) and distinguishes between immutable factual actions and lightweight narrative edits.
Derives operator-facing fields from the durable evidence spine, ensuring that features like severity, journey impact, or mitigation state are computed deterministically without modifying the core domain schemas.
A Plug to handle incoming MCP connections via HTTP SSE. Accepts JSON-RPC POST requests and streams responses back as SSE chunks.
A plug for extracting HTTP metrics and emitting them as Telemetry events.
A Plug to receive webhooks from Alertmanager and route them to the AlertProcessor.
Defines a behaviour for synthetic probes.
A simple GenServer-based scheduler for executing synthetic probes.
Optional Oban worker for scheduling synthetic probes without retries.
A DSL for defining standardized runbooks.
Defines a Service-Level Objective (SLO) within Parapet.
Built-in Phase 5 delivery slices for Chimeway.
Generates provider-first Prometheus recording and alert rules from
bounded slice specs while retaining legacy %Parapet.SLO{} support.
Provides an out-of-the-box SLO definition for HTTP request serving.
Provides an out-of-the-box SLO definition for the standard login journey.
Built-in Phase 5 delivery slices for Mailglass.
Provides an out-of-the-box SLO definition for Oban job processing.
Behaviour for providing SLOs to the Parapet system.
Protocol to transform provider structs to Parapet.SLO.t().
Built-in Phase 5 async reliability slices for Rindle.
Defines an SLO based on Scoria AI evaluation pass rates.
Bounded provider-owned slice description for Phase 5 generators.
Extends Parapet.SLO.StarterPack.WebSaaS with Mailglass and Chimeway delivery SLO slices.
Opinionated first-SLO pack for Phoenix SaaS teams.
Durable ownership record for a logical automation or escalation action.
Core Ecto Schema representing an ActionItem for durable workflow approvals.
Processes alert batches received from webhooks.
Ecto schema representing a durable evidence incident.
Ecto schema representing a general system event (like a flag mutation or deployment). These are buffered and pruned periodically.
A built-in GC pruner to prevent Parapet.Spine.SystemEvent storage bloat.
Periodically deletes events older than a specified threshold.
Ecto schema representing an entry in a durable incident timeline.
Ecto schema representing an audit record of a tool execution.
Public contract helpers for Parapet's async and delivery telemetry families.
Mix Tasks
Archives resolved incidents older than the retention window to a JSONL file.
Statically analyzes the application's Parapet configuration and exposes a runtime-oriented
cluster mode for live facts.
Generates the Parapet migration that updates archive-related indexes and constraints.
Generates importable Grafana dashboards and provisioning YAML based on the user's SLOs.
Generates valid Prometheus recording and alerting rules based on the user's defined SLOs.
Generates a fixed host-owned runbook catalog for Parapet.
Generates Grafana dashboards and Prometheus rules for Parapet's Scoria AI telemetry integration.
Installs the Parapet Evidence Spine by generating migrations and configuring the host Ecto Repo.
Generates Parapet operator UI components for the host Phoenix application.
Installs Parapet into a Phoenix application by scaffolding the host-owned instrumenter and wiring it into the endpoint.
Verifies that all public API modules have documentation and a stability-tier declaration, and generates a manifest.