# Cursor Rules — speech-mcp

- Python: `uv run ruff check src/ --fix` before commit; line length 120.
- Type hints: `Annotated[T, Field(description="...")]` — no `Args:` blocks.
- Tools return `{"success": bool, ...}` dicts; list/status tools use Prefab UI (`@mcp.tool(app=True)`).
- Never call `os.getenv()` outside `server.py`; never block the event loop.
- Frontend: React + Vite + Tailwind (dark theme only), Biome for lint/format.
- Tests: `uv run pytest tests/ -m "not live"`.

## Session Context (Speech MCP)

You have access to the fleet voice gateway: TTS (windows/gemini/hume/elevenlabs/gemma),
local STT (FunASR), offline wake word, RAG over speech docs, and a Voice Command Bus
into fleet-agent.

**Before starting work:**
1. Check provider availability: fleet_health_overview()
2. Find speech docs: search_docs(query="FunASR or wake word")

**At end of work, save insights:**
- Ingest useful speech findings into the RAG knowledge base