<p align="center">
<img src="https://raw.githubusercontent.com/zsumz/bornera/main/bornera-logo.svg" alt="bornera" width="720">
</p>
<p align="center">
<strong>Deterministic connection ownership for native protocol clients.</strong>
</p>
<p align="center">
Bornera owns bounded connection lifecycles between protocol codecs and
sockets without taking over protocol semantics, retry policy, or public APIs.
</p>
<p align="center">
<a href="#model">Model</a>
<span> · </span>
<a href="#crates">Crates</a>
<span> · </span>
<a href="#start">Start</a>
<span> · </span>
<a href="#qualification">Qualification</a>
</p>
<br />
## Model
Bornera reserves bounded capacity before a protocol adapter prepares a frame,
then takes ownership only when the complete frame is committed:
```text
reserve -> prepare -> commit -> drive -> complete or recover
```
The production owner runs many connection slots through one selector. The same
selector-free policy can also run under deterministic simulation.
## Crates
| `bornera` | Shared-selector production ownership for native transports |
| `bornera-core` | Sans-I/O admission, framing, deadlines, delivery, and recovery policy |
| `bornera-rustls` | Bounded rustls client transport and socket-free server session |
| `bornera-sim` | Unpublished deterministic trace replay and generated properties |
The crates remain version-locked during pre-alpha. The rustls server session is
socket-free in ownership, source, and operation. It is not yet isolated from
the production client stack in the crate dependency graph.
## Start
```toml
[dependencies]
bornera = "=0.0.1-rc.4"
bornera-core = "=0.0.1-rc.4"
calandria = { version = "=0.0.1-rc.2", features = ["std"] }
```
Run the embedded production example from a checkout:
```sh
cargo run -p bornera --example embedded --locked --offline
```
See the [dedicated-owner example](https://github.com/zsumz/bornera/blob/main/crates/bornera/examples/dedicated.rs)
for the thread-owned hosting model and the [architecture guide](https://github.com/zsumz/bornera/blob/main/docs/architecture.md)
for TLS setup and integration boundaries.
## Guarantees
- Admission is bounded before ownership transfers.
- Accepted work completes exactly once or transfers through explicit recovery.
- Delivery certainty is intentionally limited to `NotSent` and `PossiblySent`.
- Connection generations and epochs fence stale work.
- Protocol semantics, routing, retries, DNS, and address selection stay with the caller.
## Documentation
- [Architecture and ownership](https://github.com/zsumz/bornera/blob/main/docs/architecture.md)
- [Qualification and release proof](https://github.com/zsumz/bornera/blob/main/docs/qualification.md)
- [API documentation](https://docs.rs/bornera)
## Qualification
```sh
zcheck
```
The canonical gate covers architecture, formatting, Clippy, rustdoc, tests,
package contents, and packaged-crate smoke compilation. Bornera requires Rust
1.88 or newer; the full evidence matrix is documented in
[qualification](https://github.com/zsumz/bornera/blob/main/docs/qualification.md).
## License
Apache-2.0. See [LICENSE](LICENSE).