Judilibre — jurisprudence judiciaire

Ce skill interroge l'API Judilibre (Cour de cassation) pour rechercher et lire des décisions de justice de l'ordre judiciaire. Le travail se fait via le script scripts/judilibre_client.py, qui gère l'authentification et renvoie du JSON.

Périmètre — à dire à l'utilisateur si besoin

• ✅ Couvre : Cour de cassation (toutes chambres), et de plus en plus les cours d'appel et juridictions du premier degré (montée en charge progressive).
• ❌ Ne couvre PAS : les textes (codes, lois, décrets) ni la jurisprudence administrative (Conseil d'État, CAA, TA). Pour cela, renvoyer vers OpenLegi / Légifrance ou une autre source.

Configuration (une seule fois)

Le script a besoin d'une clé PISTE et d'un accès réseau autorisé.

1. Clé d'API (mode KeyId — recommandé). Une simple clé d'API suffit : c'est le mode KeyId, où la clé est envoyée dans l'en-tête HTTP. Le script lit la clé dans cet ordre : argument --key, variable d'environnement JUDILIBRE_KEY_ID, puis scripts/config.json. Si aucune clé n'est trouvée, le script renvoie une erreur explicite. Dans ce cas, demander sa clé à l'utilisateur, puis créer scripts/config.json à partir de scripts/config.example.json en collant la clé dans le champ key_id et en réglant env sur prod (ou sandbox). Le client OAuth (client_id / client_secret) n'est PAS nécessaire en mode KeyId : laisser ces champs vides.

   Mode OAuth2 (avancé, repli). Si l'utilisateur n'a pas de KeyId mais un couple client_id / client_secret, renseigner ces deux champs et laisser key_id vide ; le script obtiendra et mettra en cache un jeton Bearer automatiquement.

   ⚠️ scripts/config.json contient la clé en clair : ne jamais l'afficher ni le partager.

2. Réseau. L'appel sort vers *.piste.gouv.fr. Si le script renvoie une erreur « Connexion impossible à piste.gouv.fr » ou « Domaine réseau non autorisé », prévenir l'utilisateur qu'il doit autoriser le domaine dans les réglages réseau de l'exécution de code de Claude :

   • api.piste.gouv.fr — indispensable (production, mode KeyId) ;
   • sandbox-api.piste.gouv.fr — seulement pour le bac à sable ;
   • oauth.piste.gouv.fr et sandbox-oauth.piste.gouv.fr — seulement pour le mode OAuth2.

Vérifier que tout fonctionne : python3 scripts/judilibre_client.py test. Cette commande effectue une vraie recherche authentifiée (et non un simple healthcheck), donc un succès confirme bien que la clé est acceptée.

Utilisation

Installer la dépendance si nécessaire : pip install requests (silencieux si déjà présent).

Rechercher

python3 scripts/judilibre_client.py search "période d'essai rupture abusive" \
  --chamber soc --page-size 10

Filtres disponibles (tous facultatifs). Plusieurs valeurs sont acceptées pour les filtres de catégorie (les séparer par un espace) : --chamber (soc, civ1, civ2, civ3, comm, crim…), --jurisdiction (cc, ca, tj), --type, --theme, --publication, --solution, --field, --operator (and|or|exact), --date-start AAAA-MM-JJ, --date-end AAAA-MM-JJ, --page, --page-size (max 50), --sort (score|date), --order (asc|desc).

Exemple multi-valeurs : --chamber soc comm cherche dans les deux chambres.

La sortie est du JSON. Champs utiles par résultat : id, number/numbers, jurisdiction, chamber, formation, decision_date, solution, ecli, publication, summary, themes, score, et url (lien public direct vers la décision sur courdecassation.fr, ajouté par le script).

Lire une décision complète

Reprendre l'id d'un résultat de recherche :

python3 scripts/judilibre_client.py decision <id>

Renvoie le texte intégral (text), un lien public (url) et le zonage (zones : introduction, exposé, moyens, motivations, dispositif, annexes).

Connaître les valeurs d'un filtre

python3 scripts/judilibre_client.py taxonomy chamber

Présentation des résultats à l'utilisateur — TOUJOURS

Après une recherche, ne pas recracher le JSON brut. Présenter une liste claire, classée par pertinence, où chaque décision indique : juridiction et chambre, numéro de pourvoi, date, solution (cassation, rejet…), niveau de publication (P, B…), un résumé court si disponible, et le lien public (url) vers le texte. Conserver l'id pour pouvoir ouvrir le texte intégral à la demande. Proposer d'afficher l'arrêt complet ou d'affiner la recherche (chambre, période).

Toujours rappeler que ce sont des décisions de l'ordre judiciaire uniquement.

En cas d'erreur

Le script renvoie des messages JSON explicites (error + fix). Les relayer simplement à l'utilisateur :

• clé manquante → demander la clé et l'enregistrer dans scripts/config.json ;
• 401 → mauvaise clé ou mauvais environnement (sandbox vs prod) ;
• 403 → CGU Judilibre non validées ou API non rattachée à l'application PISTE ;
• 429 / 5xx → quota atteint ou API indisponible ; le script réessaie automatiquement, sinon attendre un peu et relancer ;
• connexion impossible / domaine non autorisé → autoriser api.piste.gouv.fr dans les réglages réseau.