# oban_powertools v0.5.0 - Table of Contents

## Pages

- [ObanPowertools](readme.md)
- [Changelog](changelog.md)

- Day 0
  - [Example App Walkthrough](example-app-walkthrough.md)
  - [First Operator Session](first-operator-session.md)
  - [Installation](installation.md)

- Builders
  - [Lifeline And Repairs](lifeline-and-repairs.md)
  - [Limits And Explain](limits-and-explain.md)
  - [Policy Integration Patterns](policy-integration-patterns.md)
  - [Workers And Idempotency](workers-and-idempotency.md)
  - [Workflows](workflows.md)

- Operations
  - [Forensics and Runbook Handoffs](forensics-and-runbook-handoffs.md)
  - [Optional Oban Web Bridge](optional-oban-web-bridge.md)
  - [Production Hardening](production-hardening.md)
  - [Support Truth And Ownership Boundaries](support-truth-and-ownership-boundaries.md)
  - [Troubleshooting](troubleshooting.md)
  - [Upgrade &amp; Compatibility](upgrade-and-compatibility.md)

## Modules

- [ObanPowertools](ObanPowertools.md): Phoenix-first operator primitives for Oban-backed applications.
- [ObanPowertools.Audit](ObanPowertools.Audit.md): Normalized audit writer and reader for smart-engine events.

- [ObanPowertools.Auth](ObanPowertools.Auth.md): Defines the strict Auth behaviour for Oban Powertools.

- [ObanPowertools.ControlPlane](ObanPowertools.ControlPlane.md): Shared machine-facing control-plane taxonomy for operator surfaces.

- [ObanPowertools.Cron](ObanPowertools.Cron.md): Durable cron entry sync, slot claim, and operator actions.

- [ObanPowertools.Cron.Entry](ObanPowertools.Cron.Entry.md): Durable cron entry definition.

- [ObanPowertools.Cron.Slot](ObanPowertools.Cron.Slot.md): Durable cron slot claim ledger.

- [ObanPowertools.Explain](ObanPowertools.Explain.md): Structured, snapshot-aware explain contract for smart-engine blockers.

- [ObanPowertools.Forensics](ObanPowertools.Forensics.md)
- [ObanPowertools.Forensics.Chronology](ObanPowertools.Forensics.Chronology.md)
- [ObanPowertools.Forensics.EvidenceBundle](ObanPowertools.Forensics.EvidenceBundle.md): Assembles a normalized forensic evidence bundle from raw attrs.
- [ObanPowertools.Forensics.Provenance](ObanPowertools.Forensics.Provenance.md)
- [ObanPowertools.HostEscalation](ObanPowertools.HostEscalation.md): Dispatches optional host-owned follow-up callbacks after native remediation.

- [ObanPowertools.HostEscalationHandler](ObanPowertools.HostEscalationHandler.md): Host-owned callback behaviour for post-remediation follow-up.
- [ObanPowertools.Idempotency](ObanPowertools.Idempotency.md): Handles durable idempotency receipts and atomic job insertion.

- [ObanPowertools.Idempotency.Receipt](ObanPowertools.Idempotency.Receipt.md)
- [ObanPowertools.Jobs](ObanPowertools.Jobs.md): Native job query context for the read-only job browse surface.
- [ObanPowertools.Lifeline](ObanPowertools.Lifeline.md): Durable heartbeat refresh, health classification, and incident projection.

- [ObanPowertools.Lifeline.ArchiveRun](ObanPowertools.Lifeline.ArchiveRun.md): Durable archive/prune run ledger for evidence retention.

- [ObanPowertools.Lifeline.Heartbeat](ObanPowertools.Lifeline.Heartbeat.md): Durable executor heartbeat evidence for Phase 4 liveness.

- [ObanPowertools.Lifeline.HeartbeatWriter](ObanPowertools.Lifeline.HeartbeatWriter.md): Periodically refreshes durable executor heartbeats from a configured provider.

- [ObanPowertools.Lifeline.Incident](ObanPowertools.Lifeline.Incident.md): Durable read model for Phase 4 dead-executor and workflow-stuck incidents.

- [ObanPowertools.Lifeline.RepairPreview](ObanPowertools.Lifeline.RepairPreview.md): Durable preview token and drift boundary for native operator mutations.

- [ObanPowertools.Lifeline.TargetType](ObanPowertools.Lifeline.TargetType.md): Closed-enum dispatcher for Lifeline `target_type` string → atom conversion.
- [ObanPowertools.Limits](ObanPowertools.Limits.md): Durable smart-engine limiter reservations backed by Postgres state.

- [ObanPowertools.Limits.Resource](ObanPowertools.Limits.Resource.md): Durable limiter resource definition.

- [ObanPowertools.Limits.State](ObanPowertools.Limits.State.md): Mutable limiter runtime state for a resource partition.

- [ObanPowertools.Operator](ObanPowertools.Operator.md): Programmatic API for host applications to perform operational mutations 
on jobs and workflows.

- [ObanPowertools.RuntimeConfig](ObanPowertools.RuntimeConfig.md): Centralized runtime configuration contract for required host wiring.

- [ObanPowertools.Telemetry](ObanPowertools.Telemetry.md): Public telemetry contract for Oban Powertools.
- [ObanPowertools.Web.ControlPlanePresenter](ObanPowertools.Web.ControlPlanePresenter.md): Shared control-plane labels, ownership copy, and venue-aware wording.

- [ObanPowertools.Web.ObanWebBridge](ObanPowertools.Web.ObanWebBridge.md): Thin read-only adapter from Powertools auth and display seams to documented
`Oban.Web.Resolver` callbacks for the optional `/ops/jobs/oban` mount.
- [ObanPowertools.Web.Router](ObanPowertools.Web.Router.md): Provides routing helpers to inject the Oban Powertools Web interface.
- [ObanPowertools.Web.Selectors](ObanPowertools.Web.Selectors.md): Canonical URL selector encoding for Oban Powertools native operator surfaces.
- [ObanPowertools.Worker](ObanPowertools.Worker.md): A wrapper around `Oban.Worker` that provides typed arguments and synchronous validation.

- [ObanPowertools.Workflow](ObanPowertools.Workflow.md): Explicit builder and insert API for durable workflow DAG definitions.

- [ObanPowertools.Workflow.Await](ObanPowertools.Workflow.Await.md): Durable await registration for signal-driven workflow steps.

- [ObanPowertools.Workflow.CallbackHandler](ObanPowertools.Workflow.CallbackHandler.md): Host callback behaviour for workflow outbox delivery.
- [ObanPowertools.Workflow.CallbackOutbox](ObanPowertools.Workflow.CallbackOutbox.md): Durable workflow callback outbox row.

- [ObanPowertools.Workflow.CommandAttempt](ObanPowertools.Workflow.CommandAttempt.md): Durable accepted and rejected workflow command evidence.

- [ObanPowertools.Workflow.Coordinator](ObanPowertools.Workflow.Coordinator.md): Thin PubSub-driven workflow reconciler.

- [ObanPowertools.Workflow.Edge](ObanPowertools.Workflow.Edge.md): Durable dependency edge with explicit terminal policy.

- [ObanPowertools.Workflow.RecoveryAttempt](ObanPowertools.Workflow.RecoveryAttempt.md): Durable workflow recovery request and outcome evidence.

- [ObanPowertools.Workflow.RecoverySession](ObanPowertools.Workflow.RecoverySession.md): Workflow-scoped recovery session header that groups one or more append-only recovery attempts.

- [ObanPowertools.Workflow.Result](ObanPowertools.Workflow.Result.md): Durable workflow step result evidence with bounded payload metadata.

- [ObanPowertools.Workflow.Runtime](ObanPowertools.Workflow.Runtime.md): Durable workflow runtime transitions, cancellation, awaits, signals, recovery, and callbacks.
- [ObanPowertools.Workflow.Signal](ObanPowertools.Workflow.Signal.md): Internal workflow event vocabulary and PubSub helpers.

- [ObanPowertools.Workflow.SignalRecord](ObanPowertools.Workflow.SignalRecord.md): Durable incoming workflow signal fact.

- [ObanPowertools.Workflow.Step](ObanPowertools.Workflow.Step.md): Durable workflow step definition with explicit runtime state.

- [ObanPowertools.Workflow.Workflow](ObanPowertools.Workflow.Workflow.md): Durable workflow definition plus runtime summary counters.

## Mix Tasks

- [mix oban_powertools.install](Mix.Tasks.ObanPowertools.Install.md)

