# continuum v0.5.0 - Table of Contents

OTP-native durable execution engine for Elixir.

## Pages

- [Continuum](readme.md)

- Guides
  - [Your First Workflow](your-first-workflow.md)
  - [Activities, Retries, And Idempotency](activities-retries-idempotency.md)
  - [Idempotency](idempotency.md)
  - [Multi-Instance Continuum](multi-instance.md)
  - [Clustering](clustering.md)
  - [Namespaces](namespaces.md)
  - [Search and Query](search-and-query.md)
  - [Sagas and Compensation](sagas.md)
  - [Child Workflows](child-workflows.md)
  - [Long-Running Workflows](long-running-workflows.md)
  - [Patching Workflows](patching.md)
  - [Workflow Versioning](workflow-versioning.md)
  - [Operations](operations.md)
  - [Auditing](auditing.md)
  - [Observability](observability.md)
  - [Observer](observer.md)
  - [Snapshots](snapshots.md)
  - [Determinism Rules And Replay Drift](determinism-rules.md)
  - [Migrating from v0.1 to v0.2](migrating_v0_1_to_v0_2.md)
  - [Migrating from v0.2 to v0.3](migrating_v0_2_to_v0_3.md)
  - [Migrating From v0.3 To v0.4](migrating_v0_3_to_v0_4.md)
  - [Migrating From v0.4 To v0.5](migrating_v0_4_to_v0_5.md)

## Modules

- [Continuum](Continuum.md): OTP-native durable execution engine for Elixir.
- [Continuum.Activity](Continuum.Activity.md): Defines an activity — the only place where side effects are allowed.
- [Continuum.ActivityRef](Continuum.ActivityRef.md): Handle for a successful activity that carries a compensation (saga DSL).
- [Continuum.AstCheck](Continuum.AstCheck.md): Compile-time AST scanner that rejects calls known to be non-deterministic
inside workflow code.
- [Continuum.ChildRef](Continuum.ChildRef.md): Handle for an asynchronously started child workflow.
- [Continuum.Observer](Continuum.Observer.md): Data and action helpers for the optional Continuum Observer.
- [Continuum.Observer.Router](Continuum.Observer.Router.md): Router macro for mounting the optional Continuum Observer.
- [Continuum.OpenTelemetry](Continuum.OpenTelemetry.md): Optional OpenTelemetry bridge for Continuum telemetry events.
- [Continuum.Pure](Continuum.Pure.md): Mark a module as a pure helper that may be called from workflow code.
- [Continuum.Query](Continuum.Query.md): Structured read API for durable run rows.
- [Continuum.Runtime.ActivityWorker.Dispatcher](Continuum.Runtime.ActivityWorker.Dispatcher.md): Polls `continuum_activity_tasks`, leases available tasks, and starts workers.

- [Continuum.Runtime.ActivityWorker.Supervisor](Continuum.Runtime.ActivityWorker.Supervisor.md): Dynamic supervisor for activity worker processes.

- [Continuum.Runtime.ActivityWorker.Worker](Continuum.Runtime.ActivityWorker.Worker.md): Executes one leased activity task.

- [Continuum.Runtime.Context](Continuum.Runtime.Context.md): Per-run effect context, kept in the workflow process's process dictionary.
- [Continuum.Runtime.Dispatcher](Continuum.Runtime.Dispatcher.md): Polls Postgres for runnable workflow runs and starts local engines.
- [Continuum.Runtime.Effect](Continuum.Runtime.Effect.md): The bridge between workflow code and the engine.
- [Continuum.Runtime.Engine](Continuum.Runtime.Engine.md): GenServer-per-run. The heart of replay.
- [Continuum.Runtime.Journal](Continuum.Runtime.Journal.md): Behaviour for the event-history journal.
- [Continuum.Runtime.Journal.InMemory](Continuum.Runtime.Journal.InMemory.md): In-memory journal backed by a single GenServer.
- [Continuum.Runtime.Journal.Postgres](Continuum.Runtime.Journal.Postgres.md): Durable journal adapter backed by Postgres via Ecto.
- [Continuum.Runtime.Lease](Continuum.Runtime.Lease.md): Postgres lease acquisition and renewal for workflow runs.
- [Continuum.Runtime.Lease.Heartbeater](Continuum.Runtime.Lease.Heartbeater.md): Renews leases owned by local workflow engines.
- [Continuum.Runtime.Recovery](Continuum.Runtime.Recovery.md): Boot-time recovery for orphaned durable work.
- [Continuum.Runtime.RunSupervisor](Continuum.Runtime.RunSupervisor.md): DynamicSupervisor that owns one `Continuum.Runtime.Engine` process per
active run.

- [Continuum.Runtime.SignalRouter](Continuum.Runtime.SignalRouter.md): Routes external signals and child-completion wakeups to workflow processes.
- [Continuum.Runtime.TimerWheel](Continuum.Runtime.TimerWheel.md): Caches near-term durable timers and wakes runs when timers fire.
- [Continuum.Snapshot](Continuum.Snapshot.md): Compacted history prefix for long-running workflows.
- [Continuum.Telemetry](Continuum.Telemetry.md): Telemetry event names emitted by Continuum.
- [Continuum.Test](Continuum.Test.md): Public helpers for testing Continuum workflows.
- [Continuum.Test.Paranoid](Continuum.Test.Paranoid.md): Determinism safety net for the test suite — the `--paranoid` re-replay mode.
- [Continuum.VersionRegistry](Continuum.VersionRegistry.md): Registry for workflow version hashes and callable entrypoints.
- [Continuum.Workflow](Continuum.Workflow.md): Defines a durable workflow.

- Exceptions
  - [Continuum.InstanceNotRegisteredError](Continuum.InstanceNotRegisteredError.md)
  - [Continuum.NotInWorkflowError](Continuum.NotInWorkflowError.md): Raised when a workflow primitive is invoked outside a workflow process.
  - [Continuum.ReplayDriftError](Continuum.ReplayDriftError.md): Raised when the journaled history at the current cursor doesn't match the
effect that the workflow code is now requesting. Indicates a non-trivial
code change between original execution and replay.

  - [Continuum.UnknownVersionError](Continuum.UnknownVersionError.md): Raised when a durable run references a workflow version that is not loaded.

## Mix Tasks

- [mix continuum.archive_continued_chains](Mix.Tasks.Continuum.ArchiveContinuedChains.md): Deletes expired non-tail runs from `continue_as_new` chains.
- [mix continuum.audit](Mix.Tasks.Continuum.Audit.md): Audits loaded Continuum workflows and durable patch markers.
- [mix continuum.gc_versions](Mix.Tasks.Continuum.GcVersions.md): Lists or deletes unreferenced workflow-version registry rows.
- [mix continuum.gen.activity](Mix.Tasks.Continuum.Gen.Activity.md): Generates a Continuum activity module.
- [mix continuum.gen.migration](Mix.Tasks.Continuum.Gen.Migration.md): Generates the Ecto migration that creates Continuum's Postgres tables.
- [mix continuum.gen.workflow](Mix.Tasks.Continuum.Gen.Workflow.md): Generates a Continuum workflow module.
- [mix continuum.partitions.create](Mix.Tasks.Continuum.Partitions.Create.md): Creates a monthly `continuum_events` partition.
- [mix continuum.partitions.drop_old](Mix.Tasks.Continuum.Partitions.DropOld.md): Drops old `continuum_events` partitions whose rows all belong to expired runs.
- [mix continuum.partitions.list](Mix.Tasks.Continuum.Partitions.List.md): Lists managed `continuum_events` partitions and their row counts.

