turf.bzh dans Codex

# AGENTS.md

## Le projet
Ce dépôt consomme l'API hippique de turf.bzh (courses PMU françaises).

## Référence de l'API
La description complète est dans `docs/turf-bzh-api.md`.
**Lis ce fichier avant d'écrire ou de modifier un appel.** N'invente aucune adresse :
celles qui n'y figurent pas n'existent pas, et chaque tentative consomme du quota.
Spécification machine : https://www.turf.bzh/api/openapi.json

## Accès
- Base : `https://www.turf.bzh/api`
- En-tête : `Authorization: Bearer $TBZ_KEY`
- La clé vit dans l'environnement. Ne l'écris jamais dans un fichier, ne la commets
  jamais, ne la reproduis pas dans un message.
- Quotas : 60 requêtes/minute, 10 000/jour. Chaque réponse porte `meta.quota` et les
  en-têtes `X-RateLimit-*` : lis le restant plutôt que d'attendre le 429. Sur 429,
  respecte l'en-tête `Retry-After`.

## Règles d'appel
- Une course entière : `/v1/courses/{date}/{rc}/dossier`. Un appel, pas vingt.
  Paramètres : `inclure=`, `historique=0`, `format=csv|xlsx`.
- Une journée entière : `/v1/journees/{date}/partants`.
- Un historique long : `/v1/exports` (CSV mensuels compressés). Jamais une boucle
  d'appels course par course.
- Le jour de la course, la colonne `Cote` de la base est périmée : utilise `/cotes`
  (temps réel) ou le champ `Cote_BZH`.
- Un 404 peut vouloir dire « cette donnée n'existe pas pour cette course », pas
  seulement « mauvaise adresse ». Lis `error.message` et `error.route_proposee`.

## Vérifications attendues
- Avant de conclure sur un champ, vérifie son taux de remplissage via `/v1/schema` :
  une quinzaine de colonnes sont remplies à moins de 65 %.
- Compare le nombre de lignes produites au `nombre_partants` annoncé par l'API.

## Cadre non négociable
Ces données décrivent des courses, elles n'en prédisent aucune.
- Ne produis jamais de promesse de gain.
- Tout taux, rendement ou avantage doit être accompagné du nombre d'observations
  sur lequel il est mesuré.
- Les contenus éditoriaux (Renifleur, EcurieBZH, LigneBZH) portent un champ
  `avertissement` : reprends-le tel quel, ne le résume pas.

Placez ce fichier à la racine. Si vous avez plusieurs projets dans le même dépôt, un AGENTS.md par sous-dossier affine sans tout réécrire.

Lis docs/turf-bzh-api.md, puis écris un script Python qui :
1. lit la clé dans la variable d'environnement TBZ_KEY ;
2. appelle /v1/me et /v1/statut et affiche le résultat ;
3. appelle le dossier de la R1C4 du jour avec historique=0 ;
4. affiche meta.sections_servies et meta.appels_economises.

Gère le 429 en respectant Retry-After. N'écris la clé nulle part.

Si ces quatre étapes passent, votre configuration est bonne et Codex a compris la référence.