ADR Index
Architecture Decision Records for COMSTAR. Full text also lives in docs/adr/ in the main repo.
| # | Title | Status | Date | One-liner |
|---|---|---|---|---|
| 0001 | Audio routing | Accepted | 2026-08-02 | Kiosk (Chromium) is the TTS sink |
| 0002 | Avatar render path | Accepted (interim) | 2026-08-02 | Local HTMLAudio/SVG now; no streamed frames in Phase 1 |
| 0003 | Speech compute on Ada | Accepted | 2026-08-03 | Prefer Reach SpeechClient sidecars; env URL fallback |
| 0004 | Terminal control | Accepted | 2026-08-03 | Sleep + volume via tunnelled client.terminal MCP |
| 0005 | FreeIPA identity binding | Accepted | 2026-08-03 | IPA uid + comstarFaceId; biometrics stay in CPAI |
| 0006 | House presence via HA | Accepted | 2026-08-05 |
person.* is who’s-home; not hallway FSM |
| 0007 | Full-duplex + AEC | Accepted | 2026-08-05 | Default half until AEC barge-in is proven |
| 0008 | TTS engine | Proposed | 2026-08-07 | Kokoro on Ada; Piper fallback on Pi |
| 0009 | Proactive announcements | Accepted | 2026-08-07 | Intent queue; no second SessionBridge |
| 0010 | Text channel | Accepted | 2026-08-07 | Telegram; distinct session ids from terminal |
| 0011 | Road VPN phone-home | Accepted | 2026-08-07 | OpenVPN/L2TP via NM; at-home = local CIDRs |
| 0012 | Admin host network | Accepted | 2026-08-07 | Wi‑Fi + IPv4 via whitelisted nmcli |
| 0013 | AO Reach mTLS | Accepted | 2026-08-07 | HTTPS + client certs; Admin AO pairing |
| 0014 | Offline SoftAP | Accepted | 2026-08-07 |
COMSTAR-<host> open AP at 10.87.65.1
|
- Write
docs/adr/NNNN-title.mdin the main repo (Context → Decision → Consequences). - Mirror a wiki page here and link it from this index.
- Update Contracts if the decision closes a SPEC option.