# orion-error Documentation
> [简体中文](../zh/)
`orion-error` is the Rust implementation of the WuKong error governance model.
At the documentation entry point, the most important framing is this:
- **contract channel** — stable identity, category, retryability, visibility
- **diagnostic channel** — detail, source chain, operation context, key fields
- **adaptive output** — HTTP / RPC / CLI / log projections generated by policy
In this crate, those ideas map to:
- `#[derive(OrionError)]` for stable semantic identities
- `StructError<R>` as the unified runtime carrier
- `source_err(...)` for first entry and semantic-boundary wrapping
- `conv_err()` for reason remapping without rebuilding the error story
- `report()` / `identity_snapshot()` / `exposure(...)` for boundary output
Suggested reading order: start with the user guide to learn concepts and usage, then check the developer guide for public API contracts and release details.
---
## User Guide
| [Why orion-error](./user/why-orion-error.md) | Error governance motivation and examples |
| [Tutorial](./user/tutorial.md) | Getting started tutorial |
| [Protocol Contract](./user/protocol-contract.md) | Exposure projection contract |
| [Report / Exposure Boundary](./user/report-exposure-boundary.md) | Diagnostic vs exposure boundary |
| [Logging](./user/LOGGING.md) | Logging integration |
| [Comparison with thiserror](./user/thiserror-comparison.md) | Differences and coexistence |
| [Ecosystem Comparison](./user/ecosystem-comparison.md) | anyhow / thiserror / color-eyre / orion-error |
| [Large-Scale Error Governance Manifesto](./user/manifesto.md) | WuKong model, governance principles, and industrial validation |
| [Design Constraints](./user/design-constraints.md) | Known design constraints |
## Developer Guide
| [API Contract](./dev/api-contract.md) | Public API boundaries |
| [Compatibility Migration](./dev/compat-migration.md) | Migration from older APIs |
| [Public Surface Grading](./dev/public-surface-grading.md) | Layered export grading |
| [Release Checklist](./dev/release-checklist.md) | Pre-release checks |
| [Performance Benchmarks](./dev/perf/structerror-allocation.md) | Allocation benchmarks |
---
*When docs and implementation conflict, `src/`, `tests/`, `examples/` are authoritative.*