docs(README): documente les retentatives automatiques (1.1.0)

[arsenik-dtheo]

Closes #12
Partie de l'épic #6

🔍 Ce que fait cette PR

L'épic devient démontrable de bout en bout et documenté : le README décrit les retentatives automatiques (périmètre 429/529/5xx et erreurs réseau via ConnectionError, défauts 2 / 0,5 s / 8,0 s, Retry-After honoré, backoff exponentiel à jitter, rejeu à l'identique, retries silencieux), la section Configuration pointe vers les nouvelles retry_options: (avec l'exemple max_retries: 0 et la validation stricte ArgumentError), et l'ancien exemple de retry manuel — contredit par le comportement automatique livré par cet épic — est remplacé par un rescue exact. La table des erreurs s'enrichit de ConnectionError (#cause). Le CHANGELOG enregistre 1.1.0 et la version du gem est bumpée — bump unique de l'épic, porté par cette PR finale.

✅ Critères couverts

• Le README documente les retentatives : périmètre des erreurs retentées, ConnectionError, défauts (2 / 0,5 / 8,0), exemple retry_options: incluant max_retries: 0 → nouvelle section ## Retries + table Errors ; exemples vérifiés par exécution contre le gem (valeurs attendues, ArgumentError nommant la clé, mutation du Hash passé sans effet)
• Le CHANGELOG contient une entrée pour la nouvelle version décrivant le comportement de retry → ## [1.1.0]
• La version du gem est bumpée dans le code source → VERSION = "1.1.0" (+ spec de contrat de version)
• Les exemples du README sont exacts par rapport au comportement livré (validation stricte, héritage Jev) → chaque affirmation relue contre normalize_retry_options / validate_max_retries! / validate_delay! / Jev#initialize

👀 Comment vérifier

1. Lire README.md section ## Retries : un lecteur peut écrire le code de la spec sans lire le reste
2. bundle exec rspec — 268 exemples verts (aucun comportement nouveau : uniquement doc et version)

🧪 Vérifications

• Seam de test : contrat de version spec/typesafe_spec.rb (mécanisme du bump) — cf. ## Décisions de test de la spec
• typecheck propre (ruby -c sur les .rb touchés)
• suite complète verte (268 exemples)
• diff contenu dans le périmètre du ticket (README, CHANGELOG, version.rb, spec de version, lockfile)

⚠️ Écarts et arbitrages

Signalements [NIT] de la revue (cycle 1, verdict APPROVED), non bloquants, non corrigés ici :

• Le README laisse croire qu'un délai serveur Retry-After est plafonné à 8 s — il ne l'est pas (max_delay ne borne pas l'en-tête), et Retry-After: 0 est ignoré ; une phrase lèverait l'ambiguïté
• Le jitter ∈ [nominal/2 ; nominal] : le premier sommeil par défaut peut être 0,25 s, pas 0,5 s — le README ne le dit pas
• La liste réseau du README est plus étroite que NETWORK_ERRORS (TLS, flux tronqué, hôte inaccessible)
• Hygiène CHANGELOG : liens de comparaison non étendus (pattern pré-existant, laissé tel quel), ### Documentation hors types Keep a Changelog
• Les mêmes faits de retry apparaissent trois fois dans le README (intro Errors, note de table, Retries) — risque de dérive
• Hors ticket noté par le Worker : la docstring de APIError (lib) contient encore l'ancien exemple de retry manuel — commentaire de lib, au-delà du périmètre README/CHANGELOG

📚 Références

• Ticket : 05 : documentation et version #12 · Épic : retry-client: retentatives automatiques dans le client HTTP #6
• Spec : docs/plans/retry-client/spec.md
• Branche : epic-6/04-retry-options ← epic-6/05-documentation-version