dataexcept 0.1.0-beta.2

Structured errors and failure observability for data, ML, and data-engineering systems
Documentation
# Changelog

All notable changes to `dataexcept` will be documented in this file.

The project follows semantic versioning. Pre-release versions may contain API changes before the first stable release.

## [Unreleased]

## [0.1.0-beta.2] - 2026-09-25

Second public beta focused on API ergonomics, protocol-boundary validation,
feature-combination coverage, and release supply-chain metadata.

### Added

- read-only `DataError` accessors for message, module, attributes, and failure metadata;
- idiomatic `DataError -> ErrorEnvelope` conversions for owned and borrowed values;
- direct `DataError -> EnvelopeNode` conversions for protocol-boundary code;
- `ErrorEnvelope::from_json()` for parsing normal error-envelope JSON;
- CycloneDX SBOM generation and attestation in the release workflow;
- CI coverage for the optional-feature powerset with `cargo-hack`.

### Fixed

- `FailureMetadata` now validates retry-delay invariants during JSON deserialization,
  preventing invalid negative or non-finite retry delays from bypassing constructor checks.

### Compatibility

- envelope schema version remains `1.0.0`;
- the new APIs are additive within the beta line;
- SemVer compatibility checks remain enforced against the latest release tag.

## [0.1.0-beta.1] - 2026-09-24

First public beta. This release moves the crate from alpha iteration into a
SemVer-checked beta line while preserving envelope schema 1.0.0.

### Added

- full envelope protocol reader for ordinary exception, cycle, and truncation nodes;
- public envelope schema ID and version constants;
- canonical Python reference fixtures exercised directly by Rust compatibility tests;
- typed envelope inspection accessors for node kind, identity, failure metadata, chaining, and group members;
- forward-compatibility tests for additive future 1.x fields at root, nested cause, failure metadata, and group-member levels;
- beta migration guidance and an explicit envelope protocol stability policy.

### Compatibility

- Rust public API changes are now checked against the latest release tag with `cargo-semver-checks`;
- envelope schema version remains `1.0.0`;
- additive unknown fields on ordinary 1.x records remain forward-compatible;
- cycle and truncation marker shapes remain strict.


## [0.1.0-alpha.2] - 2026-09-23

Second public alpha focused on API hardening, release automation, and validation.

### Changed

- boundary option structs now use fluent setters instead of public field literals, allowing future options without breaking callers;
- parsed `W3CTraceContext` fields are private and exposed through read-only accessors so validated trace state cannot be mutated into an invalid form;
- extensible boundary, trace-conflict, and operation-context error enums are now `#[non_exhaustive]`;
- docs.rs builds all optional features and crate-level documentation reflects the full alpha API.

### Added

- runnable examples for core errors, trace-aware observability, and boundary contexts;
- CI validation for the Rust 1.85 MSRV, individual optional features, examples, and packaged crate contents;
- crates.io Trusted Publishing through GitHub OIDC;
- a SemVer compatibility gate that becomes mandatory for beta and stable releases.

## [0.1.0-alpha.1] - 2026-09-23

Initial public alpha release.

### Added

- structured `DataError` and language-neutral `ErrorEnvelope`;
- transient, permanent, and unknown failure classification;
- retryability and optional retry-after metadata;
- strict JSON serialization with cause, context, and grouped-error support;
- canonical DataExcept JSON Schema validation and cross-language fixtures;
- credential-bearing URL redaction;
- domain errors for ingestion, validation, schema, transformation, database, network, brokers, and machine learning;
- conversions from common Rust and `serde_json` errors;
- product-neutral `OperationContext` and structured observability events;
- W3C Trace Context parsing and propagation;
- optional `tracing`, OpenTelemetry, and Sentry integrations;
- framework-neutral HTTP, worker, broker, and orchestrator boundary adapters;
- CI checks for formatting, Clippy, tests, and documentation.

### Release status

This is an experimental alpha. Public APIs may change before the first stable release.