mdma-cli 4.3.0 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mdma-cli",
3
- "version": "4.3.0",
3
+ "version": "4.4.0",
4
4
  "description": "Rules opinionated pour agents de code",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -12,7 +12,8 @@
12
12
  ### Variables globales (`.zshrc` ou `.bashrc`)
13
13
 
14
14
  ```bash
15
- export ARTE_ATLASSIAN_ROOT_URL="https://mycompany.atlassian.net" # ou URL on-premise
15
+ # IMPORTANT: URL racine SANS /jira/ à la fin, et SANS espace avant le =
16
+ export ARTE_ATLASSIAN_ROOT_URL="https://mycompany.atlassian.net"
16
17
  export ARTE_ATLASSIAN_USER_EMAIL="user@email.com"
17
18
  export ARTE_ATLASSIAN_API_TOKEN="your-api-token"
18
19
  ```
@@ -31,12 +32,37 @@ export ARTE_ATLASSIAN_PROJECT_NAME="PROJ"
31
32
 
32
33
  ### Utilisation API
33
34
 
35
+ **IMPORTANT** : Pour éviter les erreurs de caractères invisibles dans le terminal, toujours passer par un script temporaire :
36
+
34
37
  ```bash
35
- # Exemple de requête JIRA
38
+ # Récupérer un ticket
39
+ cat << 'SCRIPT' > /tmp/jira_req.sh
40
+ #!/bin/bash
36
41
  curl -s -u "$ARTE_ATLASSIAN_USER_EMAIL:$ARTE_ATLASSIAN_API_TOKEN" \
37
42
  "$ARTE_ATLASSIAN_ROOT_URL/rest/api/3/issue/PROJ-123"
43
+ SCRIPT
44
+ chmod +x /tmp/jira_req.sh && /tmp/jira_req.sh
45
+
46
+ # Recherche JQL (endpoint actuel, l'ancien /search est obsolète)
47
+ cat << 'SCRIPT' > /tmp/jira_req.sh
48
+ #!/bin/bash
49
+ curl -s -G -u "$ARTE_ATLASSIAN_USER_EMAIL:$ARTE_ATLASSIAN_API_TOKEN" \
50
+ --data-urlencode 'jql=project=PROJ AND fixVersion="1.0.0"' \
51
+ --data-urlencode 'fields=key,summary,status' \
52
+ "$ARTE_ATLASSIAN_ROOT_URL/rest/api/3/search/jql"
53
+ SCRIPT
54
+ chmod +x /tmp/jira_req.sh && /tmp/jira_req.sh
38
55
  ```
39
56
 
57
+ ### Troubleshooting
58
+
59
+ | Erreur | Cause | Solution |
60
+ |--------|-------|----------|
61
+ | `not found` au source | Espace avant `=` | `export VAR="value"` sans espace |
62
+ | `API a été supprimée` | Ancien endpoint | Utiliser `/rest/api/3/search/jql` |
63
+ | `401 Unauthorized` | Token invalide | Régénérer sur id.atlassian.com |
64
+ | `blank argument` | Caractères invisibles | Utiliser un script temporaire (voir exemples ci-dessus) |
65
+
40
66
  ### Fallback
41
67
 
42
68
  Si l'API REST échoue (erreurs réseau, permissions), utiliser le MCP Atlassian :