0.1.0

Initial public version of mvx-common.

This release introduced the first common utility layer for MVX Python packages. The focus was on structured error objects and small reusable helpers that can be shared across future packages.

The release did not include the structured logger yet. Logger support is being developed after 0.1.0 and is currently tracked in Unreleased.

Added

Structured errors

Added the base structured error model used by MVX common utilities.

The first release introduced errors that can carry stable reason codes, messages, structured details, and optional causes.

This makes errors more useful for diagnostics than plain exception strings while still keeping them ordinary Python exceptions.

The initial error layer includes:

ReasonedError
StructuredError
RuntimeExtendedError
RuntimeUnexpectedError
InvalidFunctionArgumentError

These classes provide the foundation for predictable error payloads and reusable error handling across packages.

Public API error normalization

Added api_error_processor.

This helper builds a decorator for public API exception normalization.

It is intended for public boundaries where internal exceptions should not leak directly to callers.

The decorator preserves declared public errors, preserves cancellation, and wraps unexpected internal exceptions into a configured public unexpected-error type.

This gives library components a stable public error surface while preserving useful diagnostic information through the original cause.

Function identity helper

Added a helper for resolving a function’s module and qualified name.

This is useful for diagnostics and structured error metadata, especially when decorators need to preserve or report the original callable identity.

Cancellation policy helper

Added run_with_cancellation_policy for asyncio workflows.

The helper supports different cancellation handling modes and is useful when a coroutine needs explicit behavior around caller cancellation and must-finish internal work.

This is a small but important building block for future async infrastructure.

Documentation

Added documentation for the initial common utilities. The documentation describes the intended public API behavior and the design rules around public error boundaries and cancellation handling.