xtc/docs/decisions/0003-realtime-thread-rules.md
2026-11-06 15:20:20 +01:00

25 lines
632 B
Markdown

# Decision 0003: Real-Time Thread Rules
**Status:** Accepted
---
## Context
Audio glitches and unsafe graph changes can undermine the whole application.
---
## Decision
The audio callback performs bounded processing using preallocated resources. It
performs no allocation/free, blocking locks, file I/O, logging, GUI calls,
plugin loading, or waits. Graphs are prepared outside the callback and active
graph resources are retired only after safe reclamation.
---
## Consequences
Thread ownership and publication mechanisms must be documented and tested. Any
exception to these rules requires explicit evidence and review.