Hail is a standalone C library for bounded, timestamped audio capture,
playback, and full-duplex operation. Public identifiers use ha_ and HA_.
Status: Gate C portable implementation, version 0.1. The approved architecture has a working C core and deterministic virtual backend. Native CoreAudio, WASAPI, PipeWire and ALSA backends remain Gate D work; physical audio support and latency are not claimed. The ABI remains provisional.
- Repository and audio implementation audit
- Architecture and contracts proposal
- Verification plan and engineering gates
- Public API and ownership reference
- Build and integration guide
- Backend authoring boundary
- Reproducible namespace evidence
The proposal keeps DSP, codecs, speech engines, inference, networking, recording persistence, and application policy outside Hail. Hull integration is a future external adapter, not a core dependency.
cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
cmake --build build --parallel
ctest --test-dir build --output-on-failure
./build/hail_virtual_exampleNo audio hardware or external dependency is required for the virtual tests. The example uses a fixed caller-owned arena and demonstrates duplex capture, PCM playback, interruption, stale-write rejection and device loss.