Recommandations LLM :
- Prochain match équipe : `ffbb_next_match` ou `ffbb_team_summary`.
- Confrontation directe : `ffbb_match_lookup` ou `ffbb_head_to_head`.
- Calendrier club : `ffbb_club(action="calendrier")`.
- Salles par ville/CP (évite homonymies rues) : `code_postal` ou `commune`.

Pour 'classement' : Classement seul d'une poule ou d'un club. Utiliser uniquement si poule_id est connu et que team_summary n'a pas été appelé.

Outil haut niveau idéal pour répondre aux questions du type :
'Où se joue U18M2 Thiers vs Gerzat ce week-end ?' ou 'Quand a lieu le match X contre Y ?'.

Pour une vue d'ensemble avec calendrier/classement, préférer `ffbb_team_summary`.
Pour le parcours multi-phases/coupes, préférer `ffbb_bilan_saison`.

DOIT etre utilise avant `ffbb_next_match` ou `ffbb_last_result` si l'agent
ne connait pas le numero d'equipe exact ou si la categorie est ambiguë (ex: 'U11M').
Pour une équipe senior au niveau national ou régional, la catégorie FFBB interne est souvent `SEM1` ou `SEF1` ;
le serveur résout désormais `NM3`, `NM2`, `NF1`, `PNM`, `R2`, etc. vers la bonne équipe et sa poule.

Politique : si une catégorie sans numéro (ex: 'U18M') correspond à plusieurs équipes (ex: U18M1, U18M2),
retourne 'ambiguous' (confiance 0.5) sans trancher arbitrairement.
Pour des suggestions heuristiques ordonnées (U18M1 à 0.85), utiliser `ffbb_find_team_candidates`.

Évite la confusion entre équipe fanion sans numéro (ex: U13F en régional) et équipe réserve (ex: U13F2 en départemental).
Retourne la liste des candidats triés avec confiance, motif, détails de compétition et prochain match.

Politique : contrairement à `ffbb_resolve_team` (garde-fou strict), recommande l'équipe fanion (confiance 0.85) en l'absence de numéro.

Préférer cet outil pour toute question d'équipe ('Comment vont les U13M2 ?', 'NM3', etc.).
Pour une analyse multi-phases ou coupes, utiliser `ffbb_bilan_saison`.
Restituer strictement les chiffres officiels sans présumer de forfaits ou d'anomalies sur la seule base de scores faibles (fréquents en catégories jeunes).

SINGULIER UNIQUEMENT: retourne le dernier match joué d'une seule équipe.
Recommendation LLM : Si la categorie est imprécise ou sans numéro (ex: 'U11M'),
appeler d'abord `ffbb_resolve_team` pour obtenir le `numero_equipe` reel.

⚠️ SINGULIER UNIQUEMENT. Si la demande est au pluriel
("matchs restants", "derniers matchs à jouer", "calendrier"),
utiliser ffbb_club(action="calendrier") à la place.

⚠️ ATTENTION LLM : Cet outil retourne STRICTEMENT LE PROCHAIN MATCH UNIQUE.
Ne l'utilise JAMAIS si l'utilisateur demande "les prochains matchs" au pluriel.
Pour toute requête au pluriel, utilise OBLIGATOIREMENT `ffbb_club(action="calendrier")`
et filtre les résultats toi-même.

Recommendation LLM : Si la categorie est imprécise ou sans numéro (ex: 'U11M'),
appeler d'abord `ffbb_resolve_team` pour obtenir le `numero_equipe` reel.

Agrège le parcours successif avec cumul saisonnier. Pour une synthèse rapide, préférer `ffbb_team_summary`.

Permet de retrouver les articles pertinents sur les qualifications, montées/descentes,
brassages jeunes, règles techniques (durée, ballons, zone), forfaits et brûlage.
Retourne `dict` avec `results[]` (`id`, `document_id`, `article_number`, `article_title`, `relevance_score`, `content`, `topics[]`, `source_url`)
triés par pertinence ; lecture seule, idempotent, cache SWR.

Utilise cet outil quand tu ne connais pas le numéro d'article et que tu cherches par
mots-clés. Ne pas utiliser pour récupérer un article précis — utilise
`ffbb_get_regulation_article` à la place ; pour lister les documents — utilise
`ffbb_list_regulations` ; pour expliquer un départage — utilise
`ffbb_explain_tiebreak_rules` au lieu de chercher le texte. Affûte avec `level`,
`organizer`, `category` et `limit` pour réduire le bruit.

Retourne `dict` avec `document_id`, `article_number`, `titre`, `contenu` et
`saison` ; lecture seule, idempotent, sans effet de bord, cache SWR.
Utilise cet outil quand tu connais le numéro d'article et le document (obtenu via
`ffbb_list_regulations` ou `ffbb_search_regulations`) et que tu veux le contenu
verbatim. Ne pas utiliser pour rechercher par mot-clé — utilise
`ffbb_search_regulations` à la place ; pour lister les documents disponibles —
utilise `ffbb_list_regulations` ; pour expliquer un départage — utilise
`ffbb_explain_tiebreak_rules`. Si `document_id` est omis, précise `organizer`
et `season` pour lever l'ambiguïté.

Explique le calcul du point-average particulier (confrontations directes),
du quotient particulier, et du mini-championnat à 3 équipes ou plus.
Lecture seule, idempotent, sans effet de bord ; cache SWR court.

Utilise cet outil uniquement quand deux équipes ou plus sont à égalité de points
dans une poule et que tu dois expliquer pourquoi l'une est classée devant l'autre.
Avec `poule_id`, les règles sont appliquées à la poule concrète ; sans, tu obtiens
les règles génériques. Ne pas utiliser pour rechercher un extrait réglementaire —
utilise `ffbb_search_regulations` à la place ; pour récupérer le texte d'un article
précis — utilise `ffbb_get_regulation_article` ; pour lister les règlements
disponibles — utilise `ffbb_list_regulations`. Ne pas utiliser non plus pour
obtenir le classement brut — utilise `ffbb_club(action="classement")` — ni pour
le bilan chiffré — utilise `ffbb_bilan`. Utilise `ffbb_explain_tiebreak_rules`
au lieu de `ffbb_search_regulations` quand la question porte sur le départage
et non sur le texte réglementaire.

Retourne l'inventaire complet sous forme `dict` avec `documents[]`
(`document_id`, `titre`, `organizer`, `level`, `season`) trié par juridiction.
Lecture seule, idempotent, sans effet de bord ; cache SWR (TTL ≈24h).

Utilise cet outil pour découvrir les `document_id` disponibles avant d'appeler
`ffbb_get_regulation_article` ou pour choisir un périmètre avant
`ffbb_search_regulations`. Ne pas utiliser pour rechercher un extrait textuel —
utilise `ffbb_search_regulations` à la place ; pour obtenir le texte d'un article
précis — utilise `ffbb_get_regulation_article` ; pour expliquer un départage —
utilise `ffbb_explain_tiebreak_rules`. Avec `season`, filtre l'inventaire à la
saison ciblée (défaut `2026-2027`).