error_tools 0.40.0

Basic exceptions handling mechanism
Documentation
# Invariant: Zero-Cost Facade

### Scope

- **Purpose**: Guarantee that the error facade introduces no runtime overhead compared to using upstream libraries directly.
- **Responsibility**: Documents the zero-cost facade invariant — its statement, enforcement points, and violation consequences.
- **In Scope**: The mandate that all exposed items are direct pass-throughs, introducing no wrapper types, adapter functions, or intermediate allocations.
- **Out of Scope**: Performance of the underlying upstream libraries themselves — those are upstream concerns.

### Cross-References

| Type | File | Responsibility |
|------|------|----------------|
| doc | [feature/001_error_facade.md]../feature/001_error_facade.md | Facade subject to this invariant |
| doc | [feature/002_typed_errors.md]../feature/002_typed_errors.md | Typed component — pass-through only |
| doc | [feature/003_untyped_errors.md]../feature/003_untyped_errors.md | Untyped component — pass-through only |

### Invariant Statement

All items exported by `error_tools` are direct pass-throughs of upstream items. No wrapper types, no forwarding functions, and no additional allocations are introduced at any layer of the facade.

### Enforcement Mechanism

- Source inspection: the typed and untyped modules contain only pass-through declarations
- The error-with-report operation set is universally applicable to all fallible types with no runtime overhead
- The paired-result shorthand is a transparent return type abbreviation, not a wrapper type
- No intermediate modules perform data transformation

### Violation Consequences

Any wrapper type or forwarding function would impose binary-size and possibly runtime costs on every consumer, violating the design contract that `error_tools` is cost-equivalent to direct upstream imports.