À propos du projet

## Aperçu jira-integration est un plugin pour Claude Code qui traite une issue Jira depuis la création de branche jusqu'à la conception, l'implémentation, les tests, la revue et la fusion locale, et consigne les résultats de chaque étape dans Jira via des commentaires, pièces jointes et transitions de statut. Il place plusieurs issues dans une file d'attente, les épuise séquentiellement, puis résume les résultats de réussite/isolement dans un rapport d'exception unique afin que l'humain n'ait à évaluer que les cas isolés. ## Structure de fonctionnement Elle est composée de deux boucles. - Boucle d'étapes (`auto`) : une tâche progresse dans l'ordre start → approach → impl+test → review. Chaque étape est exécutée par un sous-agent isolé, et différents modèles sont assignés selon l'étape. Le portail de revue évalue le taux de correspondance conception-implémentation et le nombre de critiques à partir de valeurs structurées ; en cas d'échec, l'agent correctif fait converger via une boucle de capteurs (5 max) qui n'exécute que lint, typecheck et les tests liés, puis lance une fois l'ensemble des tests et une re-revue delta. La boucle externe a une limite de 2 exécutions. - Boucle de tâches (`loop`) : épuise dans l'ordre la file configurée par `init` et, pour chaque tâche, exécute auto → fusion locale `--no-ff` → rebase des worktrees restants. En cas d'échec du portail, d'échec d'une étape ou de conflit de fusion/rebase, seule la tâche concernée est isolée et l'on passe à la suivante. L'arrêt complet ne se produit qu'en cas de signaux d'infrastructure (authentification 401/403, connexion MCP, base endommagée) ou d'échecs consécutifs de tâches différentes. La documentation précise que le flux de contrôle est exécuté de manière déterministe par le script Workflow (`scripts/auto.workflow.js`), et non par interprétation d'invites. ## Intégration Jira Une clé d'issue correspond à une branche (`feature/<KEY>`), à un worktree et à un fichier de contexte. Le `.jira-context.json` du dépôt principal est un agrégat de toute la file ; celui de chaque worktree représente l'état de la tâche correspondante. Chaque commande déclenche des transitions de statut (à faire → en cours → en revue → terminé), des commentaires et des pièces jointes (documents approach/review, rapport de tests). L'isolement est enregistré uniquement dans l'état local, sans modification de Jira. Les appels Jira sont pris en charge par `scripts/jira-cli.py` (REST), qui n'utilise que la bibliothèque standard. Les informations d'identification sont stockées dans le bloc `jira` du `.jira-context.json` au niveau du workspace et sont automatiquement migrées depuis les variables d'environnement et la configuration MCP existante. L'enregistrement du serveur MCP est facultatif. ## Commandes principales - Création d'issues : `epic set/show/clear`, `discover`, `create` - File/automatisation : `init`, `loop`, `auto` - Étapes individuelles : `start`, `approach`, `impl`, `test`, `review`, `merge`, `pr`, `done` - Consultation/nettoyage : `status`, `report`, `clean` - Autres : `/jira setup`, `/jira dashboard` ## Règles opérationnelles L'ampleur du travail est évaluée en L1/L2/L3 pour ajuster le volume des livrables et la profondeur de la revue ; toute modification du modèle de données, des limites transactionnelles, des contrats d'API externes, de la concurrence ou des frontières de sécurité entraîne une élévation de L1 à L2. `start` peut recommander de sauter uniquement les étapes approach et test ; impl, review et merge ne sont jamais sautées. Toutes les étapes sont enregistrées dans `completedSteps`, ce qui permet de sauter les étapes déjà terminées lors d'une réexécution. ## Livrables et tableau de bord Sous `docs/`, les documents requirements, approach, test, review ainsi que review-log et run-log (jsonl) s'accumulent. run-log et review-log servent de données d'observation du harnais lui-même : taux de faux positifs des revues, durée des étapes, fréquence des corrections, raisons d'isolement, etc. Le tableau de bord, à `http://127.0.0.1:8765`, affiche en temps réel via SSE des cartes par worktree (étape en cours, appels d'outils, statut Jira, graphe de blocks). Il est réservé à localhost et sans authentification. ## Licence MIT.