spec: audio-in.md — wakeword signal, device-scoped sleep, language precedence

[JarbasAl]

Refines OVOS-AUDIO-IN-1.

Changes

• §6.5 ovos.listener.wakeword — the wake-word detection signal (wake_word required, lang optional), emitted before ovos.listener.record.started; it is the observable event behind a wake-word-derived session.request_lang in multi-wakeword deployments. Push-to-talk / ovos.mic.listen capture emits no wake-word signal.
• §6.3 device-scoped sleep — sleep is a physical device state: a sleeping service captures nothing for any session, regardless of which session carried the request. Sleep entry is unacknowledged by design; the only sleep-related emission is ovos.listener.awoken on the sleep→awake transition. (Statement lives with the sleep request itself, not in the wakeword section.)
• §5.1 language resolution as a clear rule — MUST-precedence (detected_lang → request_lang → session.lang → deployment default): a deterministic order is what lets every producer of a language hint predict the transcription language, so it is an interop rule, not tuning.
• context.voice_match marked as an illustrative key name, not claimed by this spec.
• Bus surface and conformance updated; CHANGELOG entry appended under the class-2 section (Version stays 2 — additive within the class).

No timeouts/tuning values exist in this spec; nothing to downgrade to RECOMMENDED.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f1f725ac-3fab-4134-837e-8162c3a11345

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch spec/audio-in

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}