kanbante/CHANGELOG.md

Changelog

0.12.0 — 2026-10-11

Nouveautés

• Focus du jour (issue #5) : le rituel des 3 cartes. Table today_picks ; bouton 📌 sur chaque carte du board (et sur les candidates) ; page /today calme — picks du jour avec leur colonne en direct, candidates de l'encours, reprises d'hier non terminées reproposées, récapitulatif « ça a bougé aujourd'hui » tiré du journal. Le briefing du matin inclut les sections « Focus du jour » et « À reprendre d'hier ». POST /api/today/pin (max 3, idempotent) et /unpin.
• Prévisions (issue #7) : app/forecast.py — fermetures par semaine depuis le journal (8 semaines), débit moy/min/max sur les 4 dernières semaines complètes, projection en fourchette (jamais un faux chiffre précis) et silence explicite sans historique. Affichées sur le dashboard (épuisement du backlog), dans le bandeau milestone (avec alerte si l'ETA dépasse l'échéance) et sur /forecast (sparkline SVG inline, verdict par milestone). /api/metrics expose weekly_closures et throughput_4w.
• Récit de sprint (issue #4) : app/sprint.py + page /sprint/{owner}/{repo}?milestone= — le bilan markdown du milestone écrit par le journal : livré (avec temps de cycle par carte), cartes les plus lentes, reporté avec colonnes, chiffres de la période ; boutons Copier et Télécharger .md, endpoint GET /api/sprint/... en JSON, lien « 📖 Récit de sprint » dans le bandeau milestone du board.

11 tests ajoutés (147 au total).

0.11.0 — 2026-10-11

Nouveautés

• Wallboard navigable : flèches ← / → du clavier, boutons ❮ ❯ et pastilles cliquables pour changer de projet à la demande ; une navigation manuelle met la rotation en pause 90 s, Espace bascule une pause franche (badge visible). La position est mémorisée (sessionStorage) entre les rechargements : le mur ne repart plus à la première diapo à chaque refresh — avec 12 projets actifs × 30 s, le cycle complet (6 min) dépassait le rechargement de sécurité (5 min), rendant les dernières diapos inatteignables et donnant l'impression d'un mur figé.

Correction

• L'écoute temps réel du wallboard utilisait onmessage, qui ne se déclenche jamais pour les événements SSE nommés (gitea) émis par le hub : les rechargements en direct ne partaient pas, seul le filet de 5 minutes fonctionnait. Corrigé en addEventListener('gitea', …).

3 tests ajoutés (136 au total).

0.10.0 — 2026-10-11

Nouveautés

• Mode Triage (issue #11) : vider un backlog au clavier, façon « inbox zero ». /triage liste les projets actifs et la taille de leur backlog ; /triage/{owner}/{repo} présente les cartes du Backlog une par une, plein cadre (titre, extrait du corps, étiquettes, âge), file embarquée côté client — aucun rechargement entre cartes. Décisions : 1–5 envoient dans À faire / En cours / QA / Révision / Terminé, X ferme, L ouvre le panneau d'étiquettes (bascule via l'API existante), A s'assigne l'issue (nouvel endpoint POST /api/issues/{o}/{r}/{n}/assign-self, idempotent), Entrée passe à la suivante, Z annule le dernier déplacement. Barre de progression « Carte n / N » et résumé final par décision. Les raccourcis sont affichés en permanence et cliquables. Points d'entrée : bouton « Triage du backlog » sur le board et action dans la palette Ctrl+K.

6 tests ajoutés (133 au total).

0.9.0 — 2026-10-11

Nouveautés

• Board dynamique sans refresh (issue #15) : le board reflète l'état réel en continu. Côté serveur, chaque mutation connue (déplacement, création, capture, bascule d'étiquette) est désormais diffusée sur le hub SSE — jusqu'ici seuls les webhooks émettaient — et les webhooks bénéficient du même canal pour toutes leurs actions (étiquettes, créations, éditions comprises). Nouvel endpoint GET /api/board/{owner}/{repo} : état du board en JSON avec les cartes rendues côté serveur (partiel _card.html partagé avec la page), même pipeline de réconciliation/adoption que le board HTML. Côté client, board-live.js applique le diff en place (seules les colonnes changées sont remplacées, signature par colonne), anime les cartes survivantes vers leur nouvelle place (FLIP, désactivé si prefers-reduced-motion), diffère l'application pendant un drag local, réapplique filtres/compteurs/indices, et sonde toutes les 45 s en repli (installations sans webhooks, onglet visible). Ni le défilement, ni le panneau détail, ni Sortable ne sont affectés. Focus et Wallboard conservent leur recharge douce, désormais déclenchée par toutes les mutations.

6 tests ajoutés (127 au total).

0.8.0 — 2026-10-11

Nouveautés

• Palette de commandes (issue #10) : Ctrl+K / Cmd+K (ou le bouton ⌨️ dans la navigation) ouvre sur toutes les pages une palette façon Linear/Raycast — actions de navigation, tous les projets (filtrage local instantané) et recherche globale d'issues annotées de leur colonne (nouvel endpoint GET /api/palette?q=). Navigation entièrement au clavier (↑↓, Entrée, Échap).
• Digest hebdo vers ObsiGate (issue #13) : le résumé markdown de la semaine (issues fermées enrichies de leurs titres, cartes en cours/QA/révision, compteurs du journal) est composé automatiquement le jour et l'heure choisis (KANBANTE_DIGEST_WEEKDAY / KANBANTE_DIGEST_TIME) avec notification ntfy — mais jamais livré sans approbation : l'envoi se fait d'un clic sur /digest, vers le serveur MCP d'ObsiGate (client MCP intégré : initialize + tools/call ; URL, jeton, nom d'outil et gabarit JSON d'arguments configurables ; bouton « Tester la connexion » qui liste les outils du serveur) ou vers un webhook générique (KANBANTE_DIGEST_WEBHOOK_URL, JSON {title, markdown, week}).

11 tests ajoutés (121 au total).

0.7.0 — 2026-10-11

Nouveauté

• Capture éclair (issue #12 de la feuille de route) : trois entrées, un seul geste — transformer un message en issue placée sur le board (événement created, source capture) :
  • POST /api/capture : endpoint machine-à-machine protégé par un jeton de capture dédié (KANBANTE_CAPTURE_TOKEN, en-tête X-Capture-Token ou Bearer ; distinct du jeton Gitea, révocable seul ; désactivé en 503 tant qu'il n'est pas défini ; exempté d'auth Basic et de CSRF). JSON {title, body, repo, column} ou texte libre (première ligne = titre). Dépôt par défaut : KANBANTE_CAPTURE_REPO.
  • Écoute ntfy : si KANBANTE_CAPTURE_NTFY_TOPIC est défini, un abonné en tâche de fond (flux JSON du topic, reconnexion avec recul, curseur persisté dans kv_store — aucun rejeu au redémarrage) transforme chaque message en issue. Les messages tagués kanbante sont ignorés (pas d'auto-ingestion).
  • Page /capture : formulaire de saisie rapide, statut de configuration et exemples prêts à copier (curl, ntfy). Lien « ⚡ Capture » dans la navigation de toutes les pages.

12 tests ajoutés (110 au total).

0.6.0 — 2026-10-11

Nouveautés

• Colonne QA entre « En cours » et « Révision » (🧪, étiquette kanban:qa) : une étape de validation finale avant la révision. Le flux complet devient Backlog → À faire → En cours → QA → Révision → Terminé ; la vue Focus inclut les cartes en QA.
• Wallboard (issue #14 de la feuille de route) : GET /wall, affichage plein écran pensé pour un écran d'atelier — rotation automatique (30 s) entre les projets actifs, compteurs des six colonnes, cartes en vol (En cours / QA / Révision / À faire) avec âge, fermées du jour, horloge ; rafraîchissement en direct via le flux SSE. ?repo=Proprietaire/depot fige un seul projet. Lien « 🖥️ Wallboard » ajouté à la navigation de toutes les pages.
• Réconciliation par étiquettes : si l'étiquette kanban:* d'une issue ouverte diverge de sa colonne enregistrée (modifiée dans Gitea ou par un autre outil), le board et la vue Focus adoptent la colonne de l'étiquette et journalisent le déplacement (source gitea). Règles : exactement une étiquette kanban:* fait foi ; zéro ou plusieurs = l'état local gagne ; inactif si KANBANTE_SYNC_LABELS=0. Déplacer une carte depuis Gitea devient donc possible.

10 tests ajoutés (98 au total).

0.5.2 — 2026-10-11

Correctif

• L'indice « Glissez une carte ici » restait affiché après un dépôt dans une colonne vide : il est rendu par le serveur pour les colonnes vides au chargement, et le glisser-déposer ne le retirait jamais du DOM. refreshEmptyHints() recalcule désormais l'indice d'après le contenu réel de chaque colonne après tout déplacement (et après un retour arrière en cas d'échec) : retiré dès qu'une carte est présente, rétabli quand la dernière carte part. SortableJS est en outre restreint aux seules cartes (draggable: '.kanban-card'), l'indice n'est plus un élément déplaçable parasite.

0.5.1 — 2026-10-11

Correctif critique

• Les boards étaient vides contre un vrai Gitea : l'API Gitea (1.27.3 vérifié) renvoie la clé "pull_request": null sur les issues ordinaires ; le filtre _is_issue testait la présence de la clé ("pull_request" not in item), donc chaque vraie issue était classée « pull request » et écartée. Board, vue Focus et briefing ne montraient aucune carte (le dashboard, qui lit les compteurs des dépôts, semblait normal). Corrigé : le filtre teste la valeur (not item.get("pull_request")).
• Le faux Gitea des tests omettait la clé, ce qui masquait le bug : il reproduit désormais fidèlement le payload réel (clé toujours présente, null sur les issues), plus 4 tests de régression dédiés (88 tests au total). Smoke test réel : le board bruno/flowdeck passe de 0 à 6 cartes, dont l'issue de test « test d'ajout ! ».

0.5.0 — 2026-10-11

« Palier 3 » (points 7 à 9) + board enrichi.

Ajouts

• Recherche globale (/search) : recherche d'issues dans tous les projets via l'API Gitea, résultats groupés par projet avec la colonne Kanban de chaque issue. Mes issues (/my) : les issues ouvertes assignées à l'utilisateur du jeton, tous projets confondus.
• Briefing quotidien : page /briefing (encours, activité 24 h, cartes vieillissantes, milestones proches), GET /api/briefing, et envoi ntfy manuel (POST /api/briefing/send) ou automatique à KANBANTE_BRIEFING_TIME via un planificateur interne (mémoire d'envoi en base, aucun doublon après redémarrage).
• Serveur MCP (lecture seule) : JSON-RPC 2.0 sur POST /mcp (initialize, tools/list, tools/call, ping) avec 7 outils — list_projects, get_board, get_issue, get_focus, search_issues, get_activity, get_metrics. Aucune écriture, conformément au principe « lectures d'abord ». GET /mcp décrit le serveur.
• Gestion des étiquettes sur le board : modale de gestion (lister / créer avec palette de couleurs / supprimer les étiquettes du dépôt dans Gitea) et, dans le panneau détail, ajout / retrait d'étiquettes sur l'issue en un clic, avec mise à jour immédiate de la carte. API : GET|POST /api/repos/{o}/{r}/labels, DELETE /api/repos/{o}/{r}/labels/{id}, POST /api/issues/{o}/{r}/{n}/labels.

Améliorations

• Panneau Notes du projet : repliable (bouton ⤢, état mémorisé par projet), largeur ajustable par glisser (mémorisée), et sauvegarde automatique après 1,2 s sans frappe avec indicateur d'état (le bouton manuel reste). Le formulaire quitte HTMX pour le même board.js que le reste du board.
• Navigation unifiée enrichie sur toutes les pages : Mes issues, Briefing, Recherche.

Tests

• 19 tests ajoutés (84 au total) : recherche et mes issues, briefing (page, API, envoi ntfy, format), protocole MCP, API étiquettes, marqueurs du board. Un doublon de déclaration JS attrapé par node --check avant livraison.

0.4.0 — 2026-10-11

« Palier 2 » : temps réel et visible dans Gitea — plus une refonte complète de l'interface.

Ajouts

• Webhooks Gitea + rafraîchissement en direct : POST /webhooks/gitea (signature HMAC-SHA256 vérifiée quand KANBANTE_WEBHOOK_SECRET est défini) invalide le cache de lecture, applique les fermetures / réouvertures faites dans Gitea (idempotent : l'écho de nos propres appels ne double jamais le journal) et pousse un événement SSE sur GET /api/stream. Le navigateur se recharge en douceur quand c'est sûr (onglet visible, pas de panneau ouvert, pas de saisie en cours, pas de drag) ; sinon une pastille « Nouvelle activité » propose l'actualisation.
• Synchro par étiquettes : les colonnes intermédiaires sont reflétées dans Gitea par des étiquettes kanban:todo, kanban:in_progress, kanban:review (créées au besoin, ajout / retrait granulaires — les étiquettes de l'utilisateur ne sont jamais touchées ; backlog et done = aucune étiquette). Désactivable : KANBANTE_SYNC_LABELS=0.
• Boards par milestone : GET /board/{owner}/{repo}?milestone=<titre|id> filtre le board, avec bandeau d'échéance et progression (issues fermées du milestone / total). Sélecteur de milestones au-dessus du board.

Interface (refonte complète)

• Nouveau design system : en-tête vitré sticky avec navigation en pastilles (état actif), halos d'ambiance, cartes projets qui se soulèvent au survol, barres de progression, coins plus doux, anneau de focus visible partout, prefers-reduced-motion respecté.
• Dashboard : hero avec tuiles de synthèse (projets actifs, issues fermées et déplacements sur 30 jours, temps de cycle moyen — depuis le journal), états vides guidés pour chaque onglet, raccourci / pour la recherche (aussi sur le filtre du board).
• Board : pastille « live » en cas d'activité externe, colonnes à défilement indépendant, placeholders de colonnes vides, panneau de notes explicité, drawer animé.
• Cohérence : même navigation sur les 5 pages, responsive retravaillé.

Tests

• 13 tests ajoutés (65 au total) : hub SSE et générateur de flux, webhooks (transition, idempotence, signature, JSON invalide), synchro d'étiquettes, boards par milestone, marqueurs de la refonte.

0.3.0 — 2026-10-11

« Palier 1 » : voir ce qui se passe sur les boards.

Ajouts

• Journal d'événements (board_events, append-only) : chaque création, déplacement, fermeture, réouverture et commentaire est horodaté. Il alimente la page /activity (fil tous projets), GET /api/events et GET /api/metrics (débit par type et temps de cycle moyen : entrée en « En cours » → fermeture). Les fermetures détectées lors de la réconciliation avec Gitea sont aussi journalisées (source gitea). Un reclassement dans la même colonne n'écrit pas d'événement.
• Panneau détail de carte : un clic sur une carte ouvre un panneau latéral avec le corps de l'issue rendu en markdown (marked + DOMPurify, vendorés), ses commentaires, assignés, milestone et échéance ; on peut commenter directement dans Gitea depuis le panneau (GET /api/issues/{owner}/{repo}/{n}, POST .../comments, 404 propre si l'issue n'existe pas).
• Vieillissement des cartes : badge « ⏳ N j » dès qu'une carte reste dans sa colonne au-delà de KANBANTE_AGING_DAYS (défaut 7, rouge au double). Le temps en colonne vient du journal, avec repli sur board_state.updated_at puis sur la date de création de l'issue.
• Limites WIP : KANBANTE_WIP_LIMITS="in_progress:5,review:3" — l'en-tête de colonne affiche n/limite, passe en rouge en dépassement et un toast avertit au dépôt. Limites souples : jamais bloquantes.

Tests

• 16 tests ajoutés (52 au total) : journal et métriques, détail et commentaires, vieillissement, WIP.

0.2.0 — 2026-10-11

Consolidation complète à partir d'un audit du code 0.1.0 (chaque correctif marqué « confirmé » avait été reproduit par un test avant correction).

Critiques corrigés

• Perte de données en Docker : KANBANTE_DB_PATH est enfin lue par le code — la base SQLite atterrit dans le volume /data comme prévu.
• Authentification : Basic Auth optionnelle mais recommandée (KANBANTE_AUTH_USER / KANBANTE_AUTH_PASSWORD, KANBANTE_REQUIRE_AUTH=1 pour refuser de servir sans), protection CSRF (double-submit) sur tous les POST, avertissement bruyant au démarrage quand l'auth est absente.
• Synchro bidirectionnelle : déplacer une carte vers « Terminé » ferme l'issue dans Gitea, la ressortir la rouvre (KANBANTE_SYNC_GITEA=0 pour désactiver). L'état local est réconcilié à chaque chargement de board (fermées → Terminé, supprimées → purgées).

Importants corrigés

• Classification des projets : fenêtre d'activité glissante configurable (KANBANTE_ACTIVE_WINDOW_DAYS, défaut 365) et vrai drapeau archived de Gitea — fini l'année codée en dur et l'onglet « Archivés » mensonger.
• Pagination complète des appels Gitea (le plafond serveur de 50 réponses par page ne tronque plus les dépôts ni les issues, en silence).
• get_board_state ne plante plus sur une colonne inconnue ; migration automatique des bases 0.1.0 (colonne position, notes.updated_at, nettoyage des lignes invalides).
• Gitea injoignable → page d'erreur 502 propre (JSON pour l'API) au lieu d'un 500 brut ; /api/readiness teste réellement SQLite et Gitea, /api/health reste un liveness sans dépendance.
• Dockerfile : installation après copie du code (le package installé n'est plus vide), utilisateur non-root, HEALTHCHECK, .dockerignore.

Ajouts

• Ordre des cartes persisté dans chaque colonne (aller-retour glisser-déposer → rechargement).
• Création d'issues depuis le board (POST /api/issues).
• Vue Focus (/focus) : tout ce qui est En cours / En révision, tous projets actifs confondus.
• Filtres par texte et par étiquette sur le board ; les cartes lient vers l'issue Gitea ; les pull requests ne sont plus affichées comme des issues.
• Suite de tests pytest (modèles, client Gitea, API, auth/CSRF) et CI Gitea Actions (.gitea/workflows/ci.yml).
• Fichier LICENSE (MIT, annoncé par le README depuis la 0.1.0).

Détails

• Client Gitea entièrement asynchrone (les routes ne bloquent plus la boucle d'événements), cache mémoire court des listes, en-tête Authorization seulement si un jeton est configuré, uid résolu via /user (plus de uid=1 ni d'utilisateur codés en dur), .env chargé depuis la racine du projet seulement.
• Bibliothèques JS (HTMX, Alpine, SortableJS) vendorées dans static/vendor/ : plus aucune dépendance CDN à l'exécution.
• Glisser-déposer : en cas d'échec serveur, la carte est replacée et le toast d'erreur est rouge ; les déplacements envoient l'ordre complet des colonnes source et destination.
• API : codes HTTP corrects (400 colonne invalide, 403 CSRF, 413 note trop longue — limite configurable), lifespan FastAPI à la place de on_event déprécié, imports nettoyés.
• CSS : fond des badges corrigé (color-mix() remplace l'invalide var(--accent)20).
• Recherche du dashboard : le nom des dépôts passe par un attribut data-search échappé, plus aucune interpolation dans du JS.
• docker-compose.yml : clé version: obsolète retirée, variables d'auth exposées, healthcheck.

0.1.0 — 2026-07-07

Version initiale : dashboard des projets Gitea, board Kanban 5 colonnes par dépôt (glisser-déposer SortableJS), notes par projet, état local SQLite, thème sombre, Dockerfile + docker-compose.