# terminals-core
Core runtime primitives for Terminals OS: phase dynamics, AXON wire protocol, substrate engine, and sematonic types.
## Install
```toml
# Cargo.toml
[dependencies]
terminals-core = "0.1"
```
Or via CLI:
```sh
cargo add terminals-core
```
## Quick Start
```rust
use terminals_core::phase::{kuramoto_step, order_parameter};
// Five oscillators with random initial phases
let mut phases = [0.0_f32, 1.2, 2.4, 3.6, 4.8];
let natural_freqs = [1.0; 5];
let coupling = 0.5;
let dt = 0.01;
// Advance one Kuramoto step
kuramoto_step(&mut phases, &natural_freqs, coupling, dt);
// Measure synchronisation (0.0 = incoherent, 1.0 = fully locked)
let r = order_parameter(&phases);
println!("order parameter: {r:.4}");
```
## Modules
| `phase` | Kuramoto oscillator model — step integration and order parameter measurement |
| `wire` | AXON wire protocol — frame encoding, CRC verification, zero-copy parsing |
| `primitives` | Sematonic type primitives — branded newtypes and validation helpers |
| `audio` | Audio kernel types — spectral descriptors and metric frames |
| `substrate` | Substrate engine — compute atoms, projections, and Ising thermal model |
## License
[BUSL-1.1](./LICENSE) — see LICENSE for full terms. Converts to Apache 2.0 four years after each release.