Changelog

All notable changes to the published pristine runtime package are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.4.0] - 2026-09-17

Added opaque Pristine.Cancellation tokens and a standardized %Pristine.Error{type: :cancelled} terminal error.
Added optional Pristine.Ports.Transport.capabilities/1 and send_cancelable/3 callbacks while keeping send/2 backward compatible.
Added provider-neutral Pristine.RuntimeCapabilities.transport/1 fail-closed capability discovery.
Added cancellation-aware Foundation retry waits and regression tests for token, classifier, capability, retry-delay, and pipeline preflight behavior.

Default HTTP result classification treats cancellation as non-retryable with breaker outcome :ignore, no limiter backoff, and :cancelled telemetry.
Cancelable execution never falls back to ordinary transport send/2.
Built-in Finch supports physical unary cancellation and cleanup through Execution Plane HTTP 0.2.0 and OTP :httpc, with real HTTP/1.1 socket coverage for cancellation, normal completion, and caller death.
Cancellation waits for lower execution termination and removes its watcher.

Require Foundation 0.2.2 for supervised default ETS registries and caller-owned explicit registries, eliminating transfers to Erlang :init after worker exit.
Honor live explicit rate-limit registries without requiring an ETS heir; delegate default-registry ownership/recovery to Foundation instead of creating per-request replacement tables or overwriting Foundation's persistent cache.
Include runtime guides in the Hex package used to build documentation.

Refresh all runtime, optional, and development dependency requirements and the resolved lockfile, including Execution Plane 0.3.0, Bandit 1.12.5, and Mint 1.10.0.

Optional retry_budget_ms in the Foundation adapter stops before an over-budget delay and preserves the last result.
Zero initial backoff or cap disables backoff while preserving Retry-After.
Provider-defined HTTP status range overrides through status_retry_ranges.
Exact status overrides take precedence over ranges; overlapping ranges are rejected.
Existing provider behavior is unchanged when no ranges are configured.

Added Pristine.GovernedAuthority and governed credential auth handling so authority-selected HTTP credentials can execute while direct base URLs, headers, auth overrides, and OAuth saved-token sources fail closed in governed mode.
Updated the runtime package source constraint to consume sinter 0.3.2.
Unary HTTP execution now uses the separately published execution_plane and execution_plane_http packages.

Expanded the runtime package docs to clarify auth and token-source behavior for Foundation-backed clients.

Added the client and operation-centered runtime surface around Pristine.Client, Pristine.Operation, Pristine.Response, and the SDK-facing Pristine.SDK.OpenAPI.Client helpers.
Added package-local guides, examples, docs assets, and HexDocs structure for the published runtime package.
Added Pristine.SDK.ProviderProfile and the request-spec execution boundary used by generated provider SDKs.

Rebuilt the runtime around explicit request, endpoint metadata, and adapter contracts while keeping Foundation-backed execution as the recommended production profile.
Moved the runtime into apps/pristine_runtime as the published package boundary inside the monorepo.