turf.bzh dans Codex

# AGENTS.md

## Le projet
Ce depot consomme l'API hippique de turf.bzh (courses PMU francaises).

## Reference de l'API
La description complete est dans `docs/turf-bzh-api.md`.
**Lis ce fichier avant d'ecrire ou de modifier un appel.** N'invente aucune adresse :
celles qui n'y figurent pas n'existent pas, et chaque tentative consomme du quota.
Specification machine : https://www.turf.bzh/api/openapi.json

## Acces
- Base : `https://www.turf.bzh/api`
- En-tete : `Authorization: Bearer $TBZ_KEY`
- La cle vit dans l'environnement. Ne l'ecris jamais dans un fichier, ne la commets
  jamais, ne la reproduis pas dans un message.
- Quotas : 60 requetes/minute, 10 000/jour. Sur 429, respecte l'en-tete `Retry-After`.

## Regles d'appel
- Une course entiere : `/v1/courses/{date}/{rc}/dossier`. Un appel, pas vingt.
  Parametres : `inclure=`, `historique=0`, `format=csv|xlsx`.
- Une journee entiere : `/v1/journees/{date}/partants`.
- Un historique long : `/v1/exports` (CSV mensuels compresses). Jamais une boucle
  d'appels course par course.
- Le jour de la course, la colonne `Cote` de la base est perimee : utilise `/cotes`
  (temps reel) ou le champ `Cote_BZH`.
- Un 404 peut vouloir dire « cette donnee n'existe pas pour cette course », pas
  seulement « mauvaise adresse ». Lis `error.message` et `error.route_proposee`.

## Verifications attendues
- Avant de conclure sur un champ, verifie son taux de remplissage via `/v1/schema` :
  une quinzaine de colonnes sont remplies a moins de 65 %.
- Compare le nombre de lignes produites au `nombre_partants` annonce par l'API.

## Cadre non negociable
Ces donnees decrivent des courses, elles n'en predisent aucune.
- Ne produis jamais de promesse de gain.
- Tout taux, rendement ou avantage doit etre accompagne du nombre d'observations
  sur lequel il est mesure.
- Les contenus editoriaux (Renifleur, EcurieBZH, LigneBZH) portent un champ
  `avertissement` : reprends-le tel quel, ne le resume pas.

Placez ce fichier a la racine. Si vous avez plusieurs projets dans le meme depot, un AGENTS.md par sous-dossier affine sans tout reecrire.

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

Gere le 429 en respectant Retry-After. N'ecris la cle nulle part.

Si ces quatre etapes passent, votre configuration est bonne et Codex a compris la reference.