# wireshift-core - Technical Spec
## Overview
Core primitives for `wireshift`. `wireshift-core` defines the typed operation model, pooled buffer lifecycle, completion routing, and backend traits that every higher-level crate in the workspace builds on.
## Architecture
The crate is organized into the following public modules:
- `backend`
- `buffer`
- `completion`
- `config`
- `error`
- `op`
- `ops`
- `ring`
- `strategy`
## Guarantees
- `#![forbid(unsafe_code)]` where applicable; see `src/lib.rs` for the exact lint preamble.
- All public types have doc comments.
- Error messages are actionable where applicable.
## Public API Summary
Key entry points are exported from `src/lib.rs` via `pub mod` and `pub use` re-exports.
Consult the module-level documentation in each source file for function signatures and usage examples.
## Error Handling
- `Error`