From 4d22abbde3fdca569e51f22923af62769ac63361 Mon Sep 17 00:00:00 2001
From: sylvain <tasson.sylvain@ik.mre>
Date: Thu, 12 Mar 2026 19:54:38 +0100
Subject: [PATCH] docs(v1.3.0): update README, freeze CHANGELOG, bump version

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 CHANGELOG.md   | 16 ++++++++++++++++
 README.md      | 31 ++++++++++++++++++++++++-------
 pyproject.toml |  2 +-
 3 files changed, 41 insertions(+), 8 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 49f9965..4ab1fe6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-03-12
+
+### Added
+
+- Option `--health` pour vérifier la connexion Gitea (affiche version de l'instance et nombre de repos accessibles, exit code 0 si OK, 1 sinon)
+- Colonne "Description" dans le tableau principal (tronquée à 40 caractères)
+- Option `--no-desc` pour masquer la colonne description
+- Tests edge cases : unicode, repos vides, API malformée, caractères de contrôle (30 nouveaux tests)
+
+### Fixed
+
+- Retry : gestion de HTTP 429 (rate limiting) avec respect du header `Retry-After`
+- Validation du header `Retry-After` (cap à 30 s, fallback sur backoff exponentiel pour les dates HTTP)
+- Export JSON : sanitisation des caractères de contrôle invalides (issue #12)
+
 ## [1.2.0] - 2026-03-12
 
 ### Added
@@ -46,5 +61,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/).
 - Gestion des erreurs réseau (connexion refusée, timeout, erreurs API)
 - Masquage du token dans les messages d'erreur
 
+[1.3.0]: https://gitea.tsmse.fr/admin/gitea-dashboard/compare/v1.2.0...v1.3.0
 [1.2.0]: https://gitea.tsmse.fr/admin/gitea-dashboard/compare/v1.1.0...v1.2.0
 [1.1.0]: https://gitea.tsmse.fr/admin/gitea-dashboard/compare/v1.0.0...v1.1.0
diff --git a/README.md b/README.md
index cd86138..38043d3 100644
--- a/README.md
+++ b/README.md
@@ -39,6 +39,15 @@ gitea-dashboard
 python -m gitea_dashboard
 ```
 
+### Vérification de la connexion
+
+L'option `--health` vérifie que l'instance Gitea est accessible et affiche sa version ainsi que le nombre de repos disponibles. Exit code 0 si la connexion réussit, 1 sinon.
+
+```bash
+gitea-dashboard --health
+# Gitea 1.21.4 — 12 repos accessibles
+```
+
 ### Filtrage des repos
 
 L'option `--repo`/`-r` filtre les repos à afficher (sous-chaîne, insensible à la casse).
@@ -78,6 +87,14 @@ gitea-dashboard --sort issues
 gitea-dashboard -s activity
 ```
 
+### Colonne Description
+
+Le tableau affiche par défaut une colonne "Description" (tronquée à 40 caractères). Pour la masquer :
+
+```bash
+gitea-dashboard --no-desc
+```
+
 ### Export JSON
 
 L'option `--format json` exporte les données du dashboard au format JSON au lieu de l'affichage tabulaire. Utile pour intégrer le dashboard dans d'autres outils.
@@ -90,13 +107,13 @@ gitea-dashboard --format json > export.json
 ### Exemple de sortie
 
 ```
-                       Gitea Dashboard
-┏━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
-┃ Repo            ┃ Issues ┃ Release              ┃ Dernier commit ┃
-┡━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
-│ mon-projet      │      3 │ v1.2.0 (il y a 2j)   │ il y a 3h      │
-│ autre-repo      │      0 │ —                    │ il y a 5j      │
-└─────────────────┴────────┴──────────────────────┴────────────────┘
+                              Gitea Dashboard
+┏━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ Repo            ┃ Issues ┃ Release              ┃ Dernier commit ┃ Description                              ┃
+┡━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
+│ mon-projet      │      3 │ v1.3.0 (il y a 2j)   │ il y a 3h      │ Mon super projet de dashboard            │
+│ autre-repo      │      0 │ —                    │ il y a 5j      │ —                                        │
+└─────────────────┴────────┴──────────────────────┴────────────────┴──────────────────────────────────────────┘
 
 Milestones
   mon-projet / v2.0 : 3/5 (60%)  [échéance dépassée]
diff --git a/pyproject.toml b/pyproject.toml
index 5c2e0d8..f85568a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitea-dashboard"
-version = "1.2.0"
+version = "1.3.0"
 description = "CLI dashboard for Gitea repos status"
 requires-python = ">=3.10"
 dependencies = [