From b9b729e439d9a677eef0cfaef5a1ea3d9d7dd1e3 Mon Sep 17 00:00:00 2001 From: thibaud-lclr Date: Wed, 13 May 2026 11:00:50 +0200 Subject: [PATCH] docs: ajouter CHANGELOG.md avec l'historique des versions stables Co-Authored-By: Claude Sonnet 4.6 --- CHANGELOG.md | 223 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 223 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..6e1835a --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,223 @@ +# Changelog + +Toutes les modifications notables de ce projet sont documentées ici. +Les versions RC (release candidates) ne sont pas listées. + +--- + +## [v1.11.0] — 2026-05-12 + +### Nouvelles fonctionnalités + +- **Bootstrap — masquage automatique des commandes non configurées** : les commandes dont aucun hook n'est défini dans le manifeste sont désormais automatiquement masquées de l'aide CLI, ce qui rend la sortie `--help` plus propre et adaptée à chaque projet. +- **Bootstrap — option `DisabledCommands`** : il est maintenant possible de désactiver explicitement des commandes via l'option `DisabledCommands`, indépendamment de la configuration des hooks. + +--- + +## [v1.10.0] — 2026-05-11 + +### Nouvelles fonctionnalités + +- **Bootstrap — `DefaultLoginHandler`** : un handler de login générique est désormais disponible dans le package bootstrap, utilisable par défaut pour les projets qui n'ont pas besoin d'un flux de connexion personnalisé. + +### Corrections + +- Renommage du dossier `.forgejo` corrigé suite à une erreur de casse. + +--- + +## [v1.9.0] — 2026-05-05 + +### Changements internes + +- **Migration vers Forgejo** : les workflows CI ont été migrés de GitHub Actions vers Forgejo. +- **Mise à jour du module path** : le chemin du module Go a été mis à jour pour pointer vers la forge interne. + +--- + +## [v1.8.2] — 2026-05-02 + +### Performances + +- Suppression d'un appel de sonde Bitwarden inutile lors de la génération de la description runtime, ce qui réduit les appels CLI superflus au démarrage. + +--- + +## [v1.8.1] — 2026-05-02 + +### Performances + +- La vérification de disponibilité de Bitwarden est désormais chargée de manière paresseuse (lazy), évitant une initialisation coûteuse si le secret store n'est pas utilisé. + +--- + +## [v1.8.0] — 2026-05-02 + +### Nouvelles fonctionnalités + +- **Cache Bitwarden chiffré** : les lectures de secrets Bitwarden sont maintenant mises en cache localement sous forme chiffrée, ce qui réduit considérablement le nombre d'appels au CLI `bw` durant une session. +- **Configuration du cache via `mcp.toml`** : les options de cache (durée, activation) sont configurables directement dans le manifeste du projet. +- **Helpers générés** : les helpers de code générés exposent les contrôles de cache Bitwarden, permettant aux projets scaffoldés de bénéficier automatiquement du cache. + +--- + +## [v1.7.0] — 2026-05-02 + +### Nouvelles fonctionnalités + +- **Génération de code depuis le manifeste** : le framework peut désormais générer automatiquement du code Go à partir du `mcp.toml`, incluant les helpers de champs de configuration et le code de glue pour les helpers de manifeste. Cela réduit le boilerplate dans les projets utilisant le framework. + +--- + +## [v1.6.0] — 2026-04-20 + +### Corrections + +- L'invite de connexion Bitwarden s'affiche désormais en rouge lorsque la session est absente, rendant l'état d'erreur plus visible pour l'utilisateur. + +--- + +## [v1.5.1] — 2026-04-16 + +### Améliorations + +- Le script d'installation généré par le scaffold récupère désormais les binaires depuis la dernière release disponible, plutôt qu'une version fixée en dur. + +--- + +## [v1.5.0] — 2026-04-16 + +### Nouvelles fonctionnalités + +- **Fallback runtime embarqué pour les apps scaffoldées** : si le binaire runtime n'est pas trouvé dans l'environnement, les applications générées par le scaffold peuvent désormais utiliser un runtime de fallback embarqué directement dans le manifeste. + +--- + +## [v1.4.2] — 2026-04-15 + +### Nouvelles fonctionnalités + +- **Vérification Ed25519 des artefacts de release** : les artefacts téléchargés lors des mises à jour automatiques sont désormais vérifiés par signature Ed25519, garantissant leur intégrité. + +### Corrections + +- Le mécanisme de mise à jour (`self-update`) rejette maintenant les artefacts HTML (erreurs de redirection ou pages d'erreur) pour éviter d'installer un binaire corrompu. +- Durcissement du runtime scaffold et de la sécurité du processus de mise à jour. + +### Documentation + +- Le README a été réorganisé et la documentation détaillée déplacée dans des fichiers séparés. + +--- + +## [v1.4.1] — 2026-04-15 + +### Améliorations + +- L'assistant d'installation généré par le scaffold est aligné avec le dernier flux TUI, garantissant la cohérence entre le code généré et le comportement attendu. + +--- + +## [v1.4.0] — 2026-04-15 + +### Nouvelles fonctionnalités + +- **Assistant d'installation TUI pour Claude et Codex** : le scaffold injecte désormais un wizard interactif (TUI) dans le script `install.sh` des projets générés, guidant l'utilisateur lors de la première installation avec des étapes de configuration pour Claude et Codex. + +--- + +## [v1.3.2] — 2026-04-15 + +### Corrections + +- Revert des fonctionnalités `build` unifiée et matrice CI introduites en cours de cycle, jugées non stables pour cette release. + +--- + +## [v1.3.1] — 2026-04-14 + +### Nouvelles fonctionnalités + +- **CLI — vérification doctor sur les champs de profil** : un helper réutilisable permet de valider les champs de configuration résolus depuis plusieurs sources (env, fichier, défaut) lors du diagnostic `doctor`. +- **CLI — lookup multi-sources** : ajout d'un helper de résolution de valeur avec traçabilité de la source (d'où vient la valeur résolue). +- **Secretstore — helper de manifeste runtime** : ajout d'un helper facilitant l'ouverture du backend secret store depuis le manifeste runtime. +- **Bootstrap — expansion d'alias de commandes** : les commandes bootstrap peuvent maintenant définir des alias qui sont développés automatiquement. + +--- + +## [v1.3.0] — 2026-04-14 + +### Nouvelles fonctionnalités + +- **Commande `scaffold init`** : nouvelle commande CLI pour initialiser un projet MCP depuis zéro via le scaffold. +- **Générateur de scaffold MCP** : ajout d'un générateur de projet binaire MCP complet, produisant la structure de fichiers, le manifeste `mcp.toml`, et le code de démarrage. + +--- + +## [v1.2.1] — 2026-04-14 + +### Améliorations + +- Les commandes `config show` et `config test` générées par le bootstrap suivent désormais une structure standardisée cohérente entre les projets. + +### Corrections + +- La CI construit le changelog depuis le dernier tag de release stable (et non depuis un tag RC). + +--- + +## [v1.2.0] — 2026-04-14 + +### Documentation + +- Mise en place de la convention de nommage des branches d'amélioration dans les instructions agents du dépôt. + +--- + +## [v1.1.0] — 2026-04-13 + +### Nouvelles fonctionnalités + +- **Migrations de configuration versionnées** : le framework gère désormais les migrations de configuration entre versions, permettant aux projets d'évoluer leur schéma de config sans casser les installations existantes. +- **Secrets structurés et politiques de backend** : support des secrets structurés (objets, non plus uniquement des chaînes) et des politiques de sélection de backend secret store par champ. + +### Documentation + +- Ajout des instructions de workflow du dépôt. + +--- + +## [v1.0.0] — 2026-04-13 + +Première release stable du framework. + +### Fonctionnalités initiales + +- **Framework MCP réutilisable** : socle commun pour construire des serveurs MCP en Go, avec gestion du cycle de vie, configuration, et intégration des outils. +- **Loader de manifeste TOML** : chargement de la configuration projet depuis un fichier `mcp.toml`. +- **Package de mise à jour** : mécanisme de self-update découplé, pilotable par des drivers de forge (GitLab, Forgejo, etc.) avec validation de checksum. +- **Bootstrap CLI optionnel** : package permettant de bootstrapper rapidement une CLI pour un projet MCP, avec commandes `config`, `login`, `doctor`, et `update` préconfigurées. +- **Workflow de release CI** : pipeline de release automatisée avec génération de changelog et publication des artefacts. + +--- + +[v1.11.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.11.0 +[v1.10.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.10.0 +[v1.9.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.9.0 +[v1.8.2]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.8.2 +[v1.8.1]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.8.1 +[v1.8.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.8.0 +[v1.7.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.7.0 +[v1.6.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.6.0 +[v1.5.1]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.5.1 +[v1.5.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.5.0 +[v1.4.2]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.4.2 +[v1.4.1]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.4.1 +[v1.4.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.4.0 +[v1.3.2]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.3.2 +[v1.3.1]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.3.1 +[v1.3.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.3.0 +[v1.2.1]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.2.1 +[v1.2.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.2.0 +[v1.1.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.1.0 +[v1.0.0]: https://forge.lclr.dev/AI/mcp-framework/releases/tag/v1.0.0