Cursor rule

1---
2description: Python style and configuration conventions
3globs: app/**/*.py
4alwaysApply: false
5---
6 
7# Python Standards
8 
9- Start every module with `from __future__ import annotations`.
10- Every module, class, and public function has a docstring in **Google style**
11  (enforced by ruff `D` rules, `pydocstyle` convention = google). Document
12  `Args:`, `Returns:`, and `Raises:` for non-trivial functions.
13- A module docstring should state the module's job; reference the relevant
14  `ARCHITECTURE.md` section when it explains a non-obvious design choice.
15 
16# Configuration, not magic numbers
17 
18All tunables (timeouts, batch sizes, TTLs, intervals, limits) live in
19`app/config.py` `Settings` and are read from the environment. Defaults should
20match `docker-compose.yml` where the var is set there; `.env.example` is the
21original frozen subset (do not modify), so newer tunables live in `Settings`
22with a sensible default only.
23 
24```python
25# ❌ BAD — hard-coded in a worker/route
26await asyncio.sleep(0.5)
27ttl = 15
28 
29# ✅ GOOD — typed, env-driven, documented in .env.example
30delay = settings.retry_base_delay_seconds
31ttl = settings.realtime_cache_ttl_seconds
32```
33 
34Run `ruff check .` before considering a change done.
35