mdma-cli 4.2.0 → 4.4.0

package/README.md

@@ -21,6 +21,26 @@ npx mdma-cli add          # default: GitHub workflow, merge auto
 npx mdma-cli add jira     # JIRA integration, milestone, anonymity
 ```
 
+### Configuration JIRA
+
+**Variables globales** (`.zshrc` ou `.bashrc`) :
+
+```bash
+export ARTE_ATLASSIAN_ROOT_URL="https://mycompany.atlassian.net"  # ou URL on-premise
+export ARTE_ATLASSIAN_USER_EMAIL="user@email.com"
+export ARTE_ATLASSIAN_API_TOKEN="your-api-token"
+```
+
+**Variable projet** (dans `CLAUDE.md` ou `.env`) :
+
+```bash
+export ARTE_ATLASSIAN_PROJECT_NAME="PROJ"  # clé du projet JIRA
+```
+
+Créer un token : [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
+
+**Fallback MCP** : si l'API échoue, le workflow propose d'utiliser `@anthropic/atlassian-mcp-server`.
+
 ## Custom mix
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdma-cli",
-  "version": "4.2.0",
+  "version": "4.4.0",
   "description": "Rules opinionated pour agents de code",
   "type": "module",
   "license": "MIT",

package/templates/workflow-jira.md

@@ -7,6 +7,70 @@
 > - Ne jamais faire d'exception, quelle que soit la taille ou nature du changement
 > - En cas de doute → STOP → demander à l'utilisateur
 
+## Configuration JIRA
+
+### Variables globales (`.zshrc` ou `.bashrc`)
+
+```bash
+# IMPORTANT: URL racine SANS /jira/ à la fin, et SANS espace avant le =
+export ARTE_ATLASSIAN_ROOT_URL="https://mycompany.atlassian.net"
+export ARTE_ATLASSIAN_USER_EMAIL="user@email.com"
+export ARTE_ATLASSIAN_API_TOKEN="your-api-token"
+```
+
+### Variable projet (`CLAUDE.md` du projet)
+
+```markdown
+## JIRA
+- **Projet** : `PROJ` (clé JIRA)
+```
+
+Ou via variable d'environnement projet :
+```bash
+export ARTE_ATLASSIAN_PROJECT_NAME="PROJ"
+```
+
+### Utilisation API
+
+**IMPORTANT** : Pour éviter les erreurs de caractères invisibles dans le terminal, toujours passer par un script temporaire :
+
+```bash
+# Récupérer un ticket
+cat << 'SCRIPT' > /tmp/jira_req.sh
+#!/bin/bash
+curl -s -u "$ARTE_ATLASSIAN_USER_EMAIL:$ARTE_ATLASSIAN_API_TOKEN" \
+  "$ARTE_ATLASSIAN_ROOT_URL/rest/api/3/issue/PROJ-123"
+SCRIPT
+chmod +x /tmp/jira_req.sh && /tmp/jira_req.sh
+
+# Recherche JQL (endpoint actuel, l'ancien /search est obsolète)
+cat << 'SCRIPT' > /tmp/jira_req.sh
+#!/bin/bash
+curl -s -G -u "$ARTE_ATLASSIAN_USER_EMAIL:$ARTE_ATLASSIAN_API_TOKEN" \
+  --data-urlencode 'jql=project=PROJ AND fixVersion="1.0.0"' \
+  --data-urlencode 'fields=key,summary,status' \
+  "$ARTE_ATLASSIAN_ROOT_URL/rest/api/3/search/jql"
+SCRIPT
+chmod +x /tmp/jira_req.sh && /tmp/jira_req.sh
+```
+
+### Troubleshooting
+
+| Erreur | Cause | Solution |
+|--------|-------|----------|
+| `not found` au source | Espace avant `=` | `export VAR="value"` sans espace |
+| `API a été supprimée` | Ancien endpoint | Utiliser `/rest/api/3/search/jql` |
+| `401 Unauthorized` | Token invalide | Régénérer sur id.atlassian.com |
+| `blank argument` | Caractères invisibles | Utiliser un script temporaire (voir exemples ci-dessus) |
+
+### Fallback
+
+Si l'API REST échoue (erreurs réseau, permissions), utiliser le MCP Atlassian :
+
+```bash
+claude mcp add atlassian -- npx -y @anthropic/atlassian-mcp-server
+```
+
 ## Étapes obligatoires
 
 ### 0. Setup Git
@@ -15,7 +79,7 @@
 - Ne jamais rationaliser ("c'est juste un petit fix")
 
 ### 1. Plan
-- Cherche dans .zshrc pour le token JIRA afin de l'utiliser en REST API avec CURL. Attention le token peut contenir des caractères spéciaux, en tenir compte dans le CURL.
+- Utilise les variables `$ARTE_ATLASSIAN_*` pour les appels API JIRA (voir Configuration ci-dessus)
 - Cherche le contenu du ticket JIRA à traiter avec l'id donné dans le prompt
 - Passe le statut du ticket JIRA à "In progress"
 - Attribue le ticket à l'utilisateur