Hail is a standalone C library for bounded, timestamped audio capture,
playback, and full-duplex operation. Public identifiers use ha_ and HA_.
Status: Gate D native implementations, version 0.1. CoreAudio, shared WASAPI, PipeWire and ALSA now accompany the portable core and deterministic virtual backend. Native platform builds and isolated loopback tests pass. Software delivery/flush measurements are recorded; physical-device qualification and physical latency measurements remain outstanding. 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
- CoreAudio virtual-device qualification
- WASAPI paired-endpoint test design
- Native software-loopback qualification
- Native backend contracts and limitations
- 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.