Agile Planner MCP Server

# Changelog ## [1.7.3] - 2025-05-13 ### Fixed - **Conformité stricte JSON-RPC 2.0 pour le mode MCP:** - Implémentation de la fonction `mcpLog` pour une gestion standardisée des logs en mode MCP - Remplacement de tous les `console.error` par des logs conformes au protocole JSON-RPC - Format homogène pour toutes les sorties du serveur MCP - **Détection intelligente des modes CLI et MCP:** - Préservation du fonctionnement CLI même avec `MCP_EXECUTION=true` ou `--mcp` - Activation du mode MCP uniquement quand nécessaire - **Problèmes de linting dans les tests:** - Correction des apostrophes françaises dans les fichiers de test - Résolution des erreurs de parsing liées aux caractères accentués ## [1.7.2] - 2025-05-12 ### Fixed - **Correction du mode MCP pour `generateFeature`:** - Amélioration de la fonction `adaptResultForMarkdown` pour extraire correctement les user stories quelle que soit leur structure - Renforcement de la fonction `createRule3Structure` avec gestion d'erreurs détaillée et logs de diagnostic - Résolution des problèmes de création de la structure RULE 3 pour les features générées via MCP - Compatibilité multi-LLM améliorée pour le traitement des formats de données variables - **Résolution du problème d'ouverture de Notepad sur Windows:** - Normalisation des flux stderr/stdout en mode MCP pour éviter l'ouverture involontaire d'applications externes - Détection intelligente du mode MCP qui préserve le fonctionnement du CLI - Désactivation des codes couleur ANSI en mode MCP pour une meilleure compatibilité multiplateforme - Forcing du mode MCP avec `--mcp` ou `MCP_EXECUTION=true` lorsqu'aucune commande CLI spécifique n'est demandée ### Improved - **Robustesse du système de génération:** - Logs de diagnostic détaillés pour faciliter l'identification des problèmes en mode MCP - Fallbacks et validations robustes des paramètres d'entrée - Sauvegarde des fichiers d'information pour référence et débogage - Meilleure traçabilité de l'exécution en mode MCP ## [1.7.1] - 2025-05-12 ### Refactor - **Réduction de la complexité cognitive dans le code critique:** - Refactorisation de `json-parser.js` pour réduire la complexité cognitive de 31 à < 15 (lint ID: 4aef1b1a-e476-4b16-8ae0-5da4f62d9058) - Refactorisation de `_createRule3Structure` dans `mcp-router.js` en 6 sous-fonctions avec responsabilités uniques (lint ID: 6e6877fb-de75-4a5b-9376-41bab2df4a4b) - Amélioration de la robustesse de `server/index.js` avec gestion optimisée des erreurs et chaînage optionnel (?.) (lint ID: 2a5bf084-b3b6-46ad-9e0e-68205cc8bc7c) ### Improved - **Validation de la structure RULE 3 dans l'interface MCP:** - Test réussi avec `test-mcp-rule3.js` validant la création correcte de la structure de dossiers - Optimisation de `test-mcp-rule3.js` avec les nouveaux utilitaires MCP (nettoyage automatique des ressources) - Conformité complète avec la spécification RULE 3 pour tous les modes d'exécution - **Amélioration de la suite de tests:** - Création d'utilitaires dédiés aux tests MCP dans `tests/utils/mcp-test-utils.js` - Optimisation des tests d'intégration pour éviter les fuites de processus et améliorer la fiabilité - Script d'exécution ciblée des tests critiques avec `scripts/run-critical-tests.js` - Stratégie de test en deux niveaux (tests critiques et tests alternatifs) ### Documentation - **Refonte majeure de la documentation architecture:** - Création de `docs/architecture/mcp-server-architecture.md` pour détailler l'architecture MCP complète - Ajout de `docs/architecture/markdown-generation.md` documentant le système de génération markdown - Création de `docs/guides/mcp-integration.md` pour faciliter l'intégration avec les clients MCP - Mise à jour de `docs/development/testing-guide.md` pour inclure les tests MCP end-to-end - Ajout de diagrammes Mermaid pour visualiser l'architecture et les flux MCP - Mise à jour des dates de modification dans tous les documents - **Nouvelle documentation de développement:** - Création de `docs/development/KNOWN_ISSUES.md` listant tous les problèmes connus et la dette technique - Création de `docs/development/REFACTORING-PLAN.md` avec un plan détaillé de refactorisation TDD - Création de `docs/development/TEST-REFACTORING.md` détaillant les tests à corriger - Création de `docs/development/ROADMAP.md` avec la feuille de route des versions futures - Mise à jour des commentaires JSDoc dans les fichiers refactorisés - Documentation du pattern d'extraction de méthode appliqué pour réduire la complexité cognitive - Amélioration de la tracabilité des erreurs dans les logs - Suppression des documents obsolètes et archivage du plan de refactorisation original - Conformité complète avec RULE 2 (documentation complète avant commit) ## [1.7.0] - 2025-05-12 ### Refactor - **Modularisation complète du CLI:** - Réduction de `cli.js` de 608 lignes à 31 lignes (bien en-dessous de la limite de 500 lignes) - Création d'une structure modulaire avec séparation claire des responsabilités : - `cli/index.js` (85 lignes) - Point d'entrée et coordination - `cli/utils.js` - Utilitaires et fonctions de support CLI - `cli/backlog.js` - Génération de backlogs - `cli/feature.js` - Génération de features - Maintien de la rétro-compatibilité avec l'API existante via un module de compatibilité ### Improved - **Améliorations de robustesse:** - Gestion intelligente du client API entre les différents modes d'exécution - Correction du problème avec `backlog-last-dump.json` pour les tests et audits - Meilleure gestion des fichiers générés avec l'option `auditMode` - Support des trois modes de fonctionnement : CLI interactif, CLI non-interactif, MCP (stdio) ### Added - **Tests d'intégration améliorés:** - Test d'intégration end-to-end pour le mode CLI - Test d'intégration end-to-end pour le mode MCP (stdio) - Tests pouvant être exécutés en mode rapide ou complet via la variable d'environnement SKIP_INTEGRATION ### Documentation - Documentation complète des modules CLI avec JSDoc - Mise à jour des commentaires pour refondation syntaxe moderne - Amélioration de la lisibilité du code et des messages logs ## [1.6.2] - 2025-05-12 ### Refactor - **Réduction de complexité cognitive:** - Refactorisé la méthode `handleInvoke` dans `mcp-server.js` en extrayant trois méthodes privées (`_handleToolNotFound`, `_sendSuccessResponse`, `_handleToolExecutionError`) pour améliorer la lisibilité et la maintenabilité. - Refactorisé la fonction `handleToolsCall` dans `mcp-router.js` en extrayant trois méthodes (`_extractToolParams`, `_getToolHandler`, `_handleToolError`) pour réduire sa complexité cognitive. - Refactorisé la fonction `handleGenerateBacklog` dans `mcp-router.js` en extrayant trois méthodes auxiliaires (`_cleanupApiClient`, `_prepareBacklogResponse`, `_handleBacklogGenerationError`). - Refactorisé la fonction `_cleanupApiClient` en extrayant des sous-fonctions (`_resetClientProperties`, `_forceGarbageCollection`) pour réduire sa complexité. - Refactorisé la fonction `initializeYargs` dans `server/index.js` en extrayant des fonctions dédiées pour chaque commande et configuration. - Amélioré la méthode `extractBacklogData` dans `schema-validator.js` en extrayant des méthodes privées (`_isWrapperMCP`, `_logExtractionDebug`) et en ajoutant une documentation claire. ### Documentation - Mise à jour de la documentation dans les fichiers refactorisés pour améliorer la compréhension du code. - Ajout de commentaires explicatifs pour les nouvelles méthodes extraites. ## [1.6.1] - 2025-05-11 ### Fixed - Refactored `parseJsonResponse` function in `server/lib/utils/json-parser.js` to significantly reduce its Cognitive Complexity from 31 to within acceptable limits (target < 15). This was achieved by extracting parsing logic into helper functions (`tryDirectParse`, `tryParseFromMarkdown`, `tryParseFirstJsonObject`) and iterating through them. This improves code maintainability and readability. (Related to lint ID: `4aef1b1a-e476-4b16-8ae0-5da4f62d9058`) - **MCP E2E Test (`tests/integration/mcp.e2e.test.js`):** - Corrected assertions for the `generateBacklog` command to align with actual output: - Updated expected success message to French: `"Backlog généré avec succès"`. - Removed incorrect assertion for `result.outputPath` (validated by file system checks). - Ensured robust error handling for file system assertions by wrapping them in a `try...catch` block and properly calling `done(error)`. - Reinstated a missing check for the existence of `backlog.json` in the output directory. - These changes resolved persistent test failures and ensure reliable testing of the `generateBacklog` MCP stdio interface. ## [1.6.0] - 2025-05-11 ### Fixed - **MCP `generateBacklog` (stdio Interface):** - Resolved `chalk is not defined` error in `server/lib/mcp-router.js` by restoring missing `require` statements. - Fixed `TypeError: ToolExecutionError is not a constructor` and `Right-hand side of 'instanceof' is not an object` in `server/lib/mcp-router.js` by correctly handling the direct JSON data return from `backlog-generator.js`. - Ensured full and correct generation of all markdown files (`epic.md`, `feature.md`, `[story-slug].md`) and directory structure according to RULE 3 when invoked via MCP stdio. - Corrected the output path for `backlog-last-dump.json` to be saved in the root of the specified output path, aligning behavior with CLI and fixing MEMORY[1045ac32-1491-4647-a1eb-9e920a769771] and MEMORY[e599048a-f87f-4c93-8816-ad563570cc62]. - Overall stability and output consistency of the MCP stdio `generateBacklog` process significantly improved, now matching CLI output. ## [1.5.0] - 2025-05-11 ### Fixed - **Markdown Output Structure:** - Corrected path generation in `server/lib/markdown/index.js` to prevent nested `.agile-planner-backlog/.agile-planner-backlog` directories. - Ensured `epics` and `orphan-stories` folders are created directly under the main `.agile-planner-backlog` directory, removing the intermediate project slug folder, to comply with RULE 3. - **Markdown Generation Error:** - Resolved `TypeError: userStoryMap.set is not a function` in `server/lib/markdown/index.js` by correctly initializing `userStoryMap` as `new Map()`. ### Refactor - **Linting:** - Removed redundant `try...catch` block around `fs-extra.ensureDirSync` in `server/lib/cli.js` to allow error propagation. - Refactored a `console.log` statement in `server/lib/markdown/index.js` to avoid nested template literals. ## [1.4.6] - 2025-05-11 ### Refactoring et robustesse - Centralisation de la gestion d’erreur dans `generateBacklog` et `generateBacklogDirect` via `handleBacklogError` - Plus aucune duplication de logique d’erreur - Robustesse et conformité TDD renforcées - README mis à jour pour documenter le format d’erreur unifié - Nécessite la mise à jour des tests d’intégration si des assertions vérifient le format d’erreur ## [1.4.5] - 2025-05-10 ### Refactoring et documentation - Ajout des tests d’intégration end-to-end : - `tests/integration/cli.e2e.test.js` (mode CLI) - `tests/integration/mcp.e2e.test.js` (mode MCP stdio) - Documentation d’architecture complète Mermaid (macro et modules détaillés) - Suppression de toute référence à MVP, itérations, scripts obsolètes dans la doc - Alignement strict avec la RULE 3 (structure backlog = epics/features/user-stories/orphan-stories) - Mise à jour des exemples et guides utilisateur ## [1.4.4] - 2025-05-10 ### Réorganisation du Projet et Amélioration de la Maintenance - ✅ Restructuration complète du projet pour améliorer la maintenabilité - ✅ Réorganisation de la documentation dans des répertoires dédiés (guides, development, api, architecture) - ✅ Déplacement des fichiers de test vers les répertoires appropriés (tests/mock) - ✅ Implémentation de l'association intelligente des features avec les epics existantes - ✅ Création d'un plan de réorganisation détaillé dans `docs/reorganisation-plan.md` - ✅ Mise à jour du README principal pour refléter la nouvelle structure - 📝 Documentation améliorée de la navigation entre les différents documents ### Correction complète des Tests - Approche TDD Wave 8 - ✅ Création de 9 nouveaux tests ultra-minimaux selon l'approche TDD Wave 8 - `validators-factory.ultra-minimal.test.js` - `errors.ultra-minimal.test.js` - `backlog-generator.minimal.test.js` - `epic-formatter.ultra-minimal.test.js` - `schema-validator.ultra-minimal.test.js` - `mcp-router.ultra-minimal.test.js` - `cli.ultra-minimal.test.js` - `format-user-story.ultra-minimal.test.js` - `rule3-structure.test.js` - Test de validation de la structure RULE 3 - ✅ Développement de scripts d'automatisation pour la correction des tests et la validation de structure: - `fix-tests.js` - Correction automatique des chemins d'importation - `fix-jest-syntax.js` - Correction automatique de la syntaxe Jest 29.7.0 - `fix-module-imports.js` - Correction des imports directs depuis les modules source - `verify-rule3-structure.js` - Vérification et création automatique de la structure RULE 3 - ✅ Création de tests super-minimaux pour isoler efficacement les problèmes : - `backlog-super-minimal.test.js` - Test de validation de la structure du module sans dépendances - `backlog-ultra-mini.test.js` - Test avec mocks pour isoler les dépendances problématiques - ✅ Résolution de plus de 60 chemins d'importation incorrects après la réorganisation - ✅ Correction des variables avec tirets (transformation en camelCase) - ✅ Documentation détaillée du processus de correction dans `docs/development/test-fix-plan.md` - ✅ Mise à jour de `TEST-ROADMAP.md` avec les progrès réalisés (71,2% des composants critiques testés) ### Améliorations et corrections - ✅ Création d'utilitaires dédiés pour la manipulation de fichiers (`file-utils.js`) - ✅ Application des principes SOLID dans la réorganisation du code - ✅ Suppression des fichiers temporaires et redondants - ✅ Automation complète de la structure RULE 3 pour la génération de backlog - Script `verify-rule3-structure.js` pour vérification et création automatique - Test unitaire `rule3-structure.test.js` pour validation - Création correcte des fichiers .md dans les répertoires appropriés - ✅ Association intelligente de features aux epics appropriées - ✅ Correction des problèmes d'import via modules façade dans les tests - Résolution du problème dans `format-user-story.test.js` - Import direct depuis les modules sources pour éviter les conflits de mock - ✅ Identification et documentation des problèmes fondamentaux de tests - Syntaxe obsolète des mocks Jest (`resolves()` → `mockResolvedValue()`) - Importations via modules façade causant des problèmes avec les mocks ## [1.4.3] - 2025-05-09 ### TDD Wave 8 - Compatibilité Multi-LLM & Structure RULE 3 - ✅ Correction systématique des tests pour Jest 29.7.0 (`.resolves()` → `.mockResolvedValue()` et `.returns()` → `.mockReturnValue()`) - ✅ Implémentation des tests ultra-minimaux pour tous les composants critiques (10 fichiers) - ✅ Test dédié `multi-llm-compatibility.ultra-minimal.test.js` pour valider la compatibilité Windsurf, Claude et Cursor - ✅ Correction du bug dans `feature-generator.js` qui causait des erreurs en cascade - ✅ Résolution de l'erreur `truncatedOutput is not defined` dans les scripts de test - ✅ Correction de la génération de fichiers selon la structure RULE 3 (`.agile-planner-backlog/`) - ✅ Résolution du problème de chemin de sortie (`outputPath`) ignoré lors de la génération - 📝 Documentation complète des progrès de compatibilité dans `MULTI_LLM_COMPATIBILITY.md` - 📝 Stratégie de test documentée dans `TEST-ROADMAP.md` avec les étapes de résolution ### Tests TDD pour structure RULE 3 - ✅ Création de tests spécifiques pour valider la structure RULE 3 (`rule3-structure.test.js`) - ✅ Test MCP dédié pour vérifier le respect de la structure avec paramètre `outputPath` - ✅ Intégration des tests selon la méthodologie TDD (tests écrits avant l'implémentation) - ✅ Double génération de `backlog.json` pour compatibilité optimale (chemin utilisateur + structure RULE 3) ### Qualité du code - ✅ Application de l'opérateur de coalescence nullish (`??`) pour améliorer la lisibilité - ✅ Correction des problèmes de linting dans les tests et scripts - ✅ Restructuration du script `run-final-tests.js` pour une meilleure robustesse - ✅ Utilisation des optional chaining pour améliorer la qualité du code ## [1.1.6] - 2025-05-08 ### Amélioré - Compatibilité multi-LLM assurée pour: - Windsurf (PRIORITÉ 1) - Claude.ai (PRIORITÉ 2) - Cursor (PRIORITÉ 3) - Tests MCP corrigés et améliorés - Nettoyage des mocks entre les tests - Test spécifique de compatibilité multi-LLM ajouté ### Corrigé - Problèmes de linting dans les scripts - Erreurs dans les tests MCP - Format des réponses JSON-RPC pour conformité MCP - Agile Planner MCP Server ## [1.4.2] - 2025-05-08 ### TDD Wave 8 - Approche critique - Tests ultra-minimaux pour les 5 composants les plus critiques - Validation complète du routeur MCP et de la conformité Context7 - Stratégie incrémentale pour améliorer progressivement la couverture de tests - Identification et suppression des tests obsolètes (tests/e2e/cli.test.js) - Audit complet de l'architecture avec rapports détaillés dans le dossier 'reports/' ## [1.4.1] - 2025-05-08 ### MCP Context7 & Test Validation - Validation complète de la conformité au protocol MCP selon les standards Context7 - Tests isolés ultra-minimaux pour garantir la robustesse des composants critiques - Vérification systématique de la gestion des erreurs MCP (validation des paramètres et formats de réponse) - Correction des problèmes de linting dans les scripts de validation - Création de scripts d'exécution ciblés pour les tests critiques (`run-critical-tests.js`) - Documentation complète de la validation MCP dans le guide de test ## [1.4.0] - 2025-05-08 ### TDD Wave 8 - Refactorisation des tests - Standardisation des mocks pour tous les tests: création de setupTests.js centralisé avec mocks communs - Configuration optimisée de Jest pour éviter les conflits entre les différentes options (resetMocks, restoreMocks, clearMocks) - Nouveau script d'exécution test:wave8 garantissant la cohérence entre npm test et npx jest - Stratégie d'isolation des tests documentée dans test-resolution-strategy.md - Résolution méthodique des conflits entre sinon et jest pour les mocks - Robustesse des tests unitaires : mocks explicites OpenAI et Groq avec baseURL, reset des mocks entre sous-tests - Correction du nom de la fonction mockée (deliver_backlog) ## v1.3.3 (2025-05-08) ### Tests & Qualité - Refactorisation complète des tests unitaires conformément aux principes Wave 8 - Standardisation des mocks pour les dépendances externes (fs-extra, chalk, etc.) - Correction systématique des chemins d'importation pour la nouvelle structure - Réorganisation hiérarchique des tests en modules (validators, formatters, utils, generators) - Isolation stricte des tests unitaires pour assurer leur fiabilité et leur maintenabilité - Uniformisation des patterns d'assertion pour mieux identifier la source des erreurs - Création d'un plan de refactorisation détaillé conforme à TDD Wave 8 (dans `test-refactoring-plan.md`) - Mise à jour du guide de test avec la stratégie de résolution TDD Wave 8 ## v1.3.1 (2025-05-08) ### Ajouté - Documentation détaillée sur la convention d'import des modules dans les tests (README du dossier tests) - Tests ultra-minimaux pour les composants les plus critiques - Guide complet pour les contributeurs (CONTRIBUTING.md) - Exemples de documentation avec Mermaid pour visualiser l'architecture - Support pour la nouvelle syntaxe des mocks Jest 29.7.0 ### Amélioré - Réduction de la duplication de code dans les tests - Isolation explicite des tests pour éviter les effets de bord - Réduction de la complexité cognitive des fonctions de test - Meilleure organisation des fixtures de test - Optimisation des imports dans les fichiers de test ### Corrigé - Problème de double import dans les tests - Erreurs liées aux mocks de fs-extra - Dépendances circulaires entre les modules - Variables inutilisées et problèmes de linting - Correction des variables inutilisées et optimisation des closures - Résolution de problèmes de qualité de code signalés par l'IDE ## v1.2.3 (2025-05-08) ### Améliorations - Support complet des formats backlog 'epic' (singulier) et 'epics' (pluriel) - Normalisation automatique des backlogs pour garantir la rétrocompatibilité - Refactorisation des validateurs pour réduire la complexité cognitive - Meilleure gestion des erreurs dans la validation des objets imbriqués - Amélioration des messages d'erreur pour faciliter le débogage - Compatibilité complète avec les spécifications MCP 2025 - Documentation détaillée sur l'utilisation et la configuration - Outils de conversion pour les backlogs existants - Meilleure organisation des modules pour faciliter la maintenance - Configuration des tests unitaires pour garantir la qualité du code - Optimisation du générateur de backlog pour améliorer les performances - Amélioration du routeur MCP pour une meilleure gestion des requêtes - Mise à jour de l'index principal pour une meilleure intégration - Amélioration des exemples d'user stories pour une meilleure compréhension - Ajout d'exemples de migration pour faciliter la transition vers le nouveau système - Mise à jour des tests pour assurer la qualité du code ## v1.2.1 (2023-11-20) ### Améliorations - Refactorisation du système de validation avec le pattern Strategy - Création de validateurs spécialisés pour chaque entité (UserStory, Feature, Epic, Iteration, Backlog) - Implémentation d'une Factory pour faciliter l'accès aux validateurs - Documentation du pattern Strategy dans `design.md` - Amélioration de la couverture de tests (100% pour les nouveaux validateurs) - Ajout d'exemples d'utilisation des validateurs dans `examples/validators-usage.js` - Ajout d'un exemple d'intégration progressive dans `examples/migration-integration.js` - Création d'un guide de test (`TESTING-GUIDE.md`) pour clarifier l'utilisation de `npm test` et `npx jest` - Identification des fichiers obsolètes dans `OBSOLETE-FILES.md` pour faciliter le nettoyage futur ### Corrections - Amélioration de la précision des messages d'erreur pour les validateurs - Réduction de la complexité cognitive dans plusieurs fonctions - Compatibilité avec l'ancien système de validation pour faciliter la migration progressive - Réduction de la complexité cognitive des fonctions de validation - Documentation complète de l'architecture des validateurs dans `server/lib/utils/validators/README.md` ## v1.2.0 (2025-05-06) ### Nouvelles fonctionnalités - Implémentation de la structure hiérarchique epic > feature > user story - Ajout de métadonnées et d'instructions AI pour faciliter le travail collaboratif avec les IA ### Améliorations - Refactorisation majeure du module markdown-generator pour améliorer la maintenabilité et la robustesse - Division du module monolithique (1124 lignes) en 7 modules spécialisés respectant la limite de 500 lignes par fichier - Préservation complète de la structure hiérarchique lorsqu'elle est appelée via l'outil MCP generateBacklog - Ajout de la licence MIT avec clause Commons sur le modèle de claude-task-master - Mise à jour des changelogs pour correspondre précisément à la version actuelle - Création d'exemples détaillés dans le dossier examples/ montrant le format exact des sorties - Enrichissement de la documentation dans les README en anglais et français - Ajout de liens vers le guide d'utilisation optimal (OPTIMAL_USAGE_GUIDE.MD) ### Corrections - Correction d'un problème critique dans la fonction `generateMarkdownFilesFromResult` empêchant la création correcte des liens entre fichiers - Normalisation des chemins relatifs pour assurer la compatibilité cross-platform - Résolution d'un problème d'encodage des caractères spéciaux dans les fichiers markdown - Amélioration de la robustesse des appels MCP - Gestion de l'ID unique pour les entités (forced 'lowercase') - Tests unitaires pour tous les composants (story, feature, epic, iteration, MVP)