# Rhiannon: Two-Way Equation Engine

Local, real-time embodiment of bounded mathematical intelligence (no cloud).

## Build
```bash
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
```

## Run
```bash
./build/rhiannon_demo --dim 1024 --iters 200 --headless
# Enable WebSocket (if built with -DRHIANNON_WITH_WS=ON)
./build/rhiannon_demo --ws 8080
```

## Options
- `--dim N`     Vector size (default 8)
- `--iters N`   Inner optimization iterations per tick (default 100)
- `--headless`  Suppress per-tick console output
- `--live-midi` Enable MIDI input (requires build with RHIANNON_WITH_MIDI_OSC)
- `--ws PORT`   Enable WebSocket metrics on `PORT` (requires RHIANNON_WITH_WS)
- `--gpu`       Hint to use accelerated path (Metal/AVX2 stubs; optional)

## Tests
```bash
ctest --test-dir build --output-on-failure
```

## Notes
- Optional features (MIDI/OSC, WebSocket, Metal) are off by default to keep the core portable.  
  Turn them on with `-DRHIANNON_WITH_MIDI_OSC=ON`, `-DRHIANNON_WITH_WS=ON`, `-DRHIANNON_WITH_METAL=ON`.
- Logging uses `spdlog` when available; otherwise falls back silently.