Adom TTS — Text to Speech

Thin Rust CLI for service-tts — Adom's shared edge-tts wrapper with pronunciation overrides + source-hash cache. Every Adom tool that renders narration (demo-recording, any walkthrough/tour) should shell to `adom-tts say` instead of calling edge-tts directly, so Adom terms like adom-tsci come out phonetically right and repeat synthesis hits the cache. Trigger words: adom-tts, text to speech, tts, narration, voiceover, synthesize speech, edge-tts, neural voice, andrew neural, pronunciation override, demo narration, walkthrough narration, say this, speak this, make audio from text, render narration, voice service, service-tts, play this audio, play the audio file, auto-play tts, narrate hands-free, drive mode, drive-mode tts, read this to me, play it back, replay last tts. HANDS-FREE TRIGGERS — when the user says ANY of these, ALWAYS reach for `adom-tts say --play` instead of writing a long text response: "I'm driving", "I am driving", "while I drive", "while driving", "can't read the screen", "can't see the screen", "can't look at the screen", "read it to me", "read this to me", "read it out loud", "read me your answer", "read me back", "read me the", "read me that", "read me that last prompt", "read me the last prompt", "read me what you just said", "read your last answer", "read your last response", "read that back", "read that back to me", "read me your last", "read back the last prompt", "narrate the answer", "say it out loud", "tell me out loud", "speak the answer", "audio answer please", "I'm in the car", "in the car right now", "on my commute", "hands-free". These phrases mean the user CANNOT see your text response — synthesize it and auto-play. Default surface is hydrogen webview; if the user seems to be on a phone via /remote-control, hydrogen still works (audio plays through phone).

Canonical table of TTS pronunciation overrides for Adom tool names, acronyms, and product terms that neural TTS engines (edge-tts, piper, azure, eleven-labs) mispronounce. Use when writing narration for any demo / walkthrough / tour / voiceover — look up each Adom-ish term in the table and spell it phonetically in the narration column. Use BEFORE rendering any TTS audio, not after. Trigger words: tts pronunciation, tts pronounce, mispronounce, how do I make TTS say, edge-tts pronounce, narration pronunciation, speak adom-tsci, demo narration phonetics. Also fires automatically whenever another skill (demo-recording, video-post, voiceover-over-a-recording) is drafting narration text.

Develop and debug adom-tts from source: run the build, add features to the player/queue, and — critically — the hard-won engineering rules for a shared audio system that many AI threads drive at once. Read before touching src/play.rs, src/player.html, or the drainer. Covers: the single-server/ single-drainer architecture (multiple AIs talk to ONE adom-tts player), never letting audio drop (buffering, retries, hotspot-proof blob playback), double-checking audio actually PLAYED (verdicts, --confirm, check), the shared queue (byte-snapshots, FIFO, position feedback), and returning good hints to every calling AI. Triggers: build adom-tts, debug adom-tts, adom-tts dev cycle, silent clips, no-playback, clips play twice, drainer, player.html, queue debugging, playback verdict, run the tests.

Cut and publish a new adom-tts release to THE Adom Wiki. Single source of truth for WHERE this app lives (https://wiki.adom.inc/adom/adom-tts — org `adom`, slug `adom-tts`) and HOW to ship it with the adom-wiki CLI (adompkg and all *.adom.cloud slug hosts are DEPRECATED — never use them). Covers the version bump, the test gate, packaging, `adom-wiki pkg publish`, `repo push` for source + dev/publish skills, keeping the hero linked, deprecating a bad version, and the mandatory verify-in-pup step. Triggers: publish adom-tts, release adom-tts, ship adom-tts, bump adom-tts, push adom-tts to the wiki, update the adom-tts page, re-link the adom-tts hero.