@atlashub/smartstack-cli 1.9.0 → 1.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, APEX, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",

package/templates/commands/gitflow/1-init.md

@@ -264,12 +264,65 @@ az devops project show --project "$AZ_PROJECT" > /dev/null 2>&1 || {
 
 ---
 
+### ÉTAPE 7.6 : Configuration de la langue
+
+> **IMPORTANT:** La langue choisie s'applique UNIQUEMENT au contenu descriptif :
+> - Description des features/hotfixes (partie apres `feature/` ou `hotfix/`)
+> - Messages de commit (partie apres le prefix `feat:`, `fix:`, etc.)
+> - Description dans les titres de PR
+>
+> **NON AFFECTE par la langue (toujours en anglais):**
+> - Prefixes de branches: `feature/`, `release/`, `hotfix/`
+> - Prefixes de commits: `feat:`, `fix:`, `chore:`, etc.
+> - Structure GitFlow
+
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "Quelle langue utiliser pour les descriptions ?",
+    header: "Langue",
+    options: [
+      { label: "English (Recommended)", description: "Feature descriptions, commit messages in English" },
+      { label: "Francais", description: "Descriptions en francais (prefixes restent en anglais)" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+**Exemple selon la langue:**
+
+| Element | English | Francais |
+|---------|---------|----------|
+| Branche | `feature/add-user-auth` | `feature/ajouter-auth-utilisateur` |
+| Commit | `feat: add user authentication` | `feat: ajouter authentification utilisateur` |
+| PR Title | `feat: Add User Authentication` | `feat: Ajouter Authentification Utilisateur` |
+| Prefixes | `feature/`, `feat:` (inchange) | `feature/`, `feat:` (inchange) |
+
+**Stocker le resultat dans la config:**
+- `language.code`: "en" ou "fr"
+- `language.descriptions`: dictionnaire des verbes d'action traduits (pour suggestions)
+
+---
+
 ### ÉTAPE 8 : Configuration
 
 ```json
 {
-  "version": "1.4.0",
+  "version": "1.5.0",
   "initMode": "clone",
+  "language": {
+    "code": "en",
+    "descriptions": {
+      "add": "add",
+      "update": "update",
+      "fix": "fix",
+      "refactor": "refactor",
+      "remove": "remove",
+      "improve": "improve",
+      "implement": "implement"
+    }
+  },
   "repository": {
     "name": "{repo_name}",
     "remoteUrl": "{REPO_URL}",
@@ -867,11 +920,31 @@ parent/
 
 ### Config.json structure
 
-#### Organized Mode (v1.3)
+#### Organized Mode (v1.5)
 ```json
 {
-  "version": "1.4.0",
+  "version": "1.5.0",
   "initMode": "organized",
+  "language": {
+    "code": "en",
+    "descriptions": {
+      "add": "add",
+      "update": "update",
+      "fix": "fix",
+      "refactor": "refactor",
+      "remove": "remove",
+      "improve": "improve",
+      "implement": "implement"
+    }
+  },
+  "naming": {
+    "normalize": true,
+    "maxLength": 50,
+    "separator": "-",
+    "lowercase": true,
+    "removeAccents": true,
+    "allowedChars": "a-z0-9-"
+  },
   "repository": { "name": "", "defaultBranch": "main", "remoteUrl": "" },
   "versioning": { "strategy": "semver", "current": "0.1.0", "source": "auto", "sourceFile": "", "tagPrefix": "v", "autoIncrement": { "feature": "minor", "hotfix": "patch", "release": "manual" } },
   "git": { "branches": { "main": "main", "develop": "develop", "feature": "feature/", "release": "release/", "hotfix": "hotfix/" }, "mergeStrategy": "--no-ff", "protectedBranches": ["main", "develop"] },
@@ -921,6 +994,96 @@ parent/
 }
 ```
 
+### Language & Naming Configuration (NEW in v1.5)
+
+La section `language` definit la langue pour le **contenu descriptif uniquement**.
+
+> **IMPORTANT - Ce qui ne change PAS selon la langue:**
+> - Prefixes de branches: `feature/`, `release/`, `hotfix/` (toujours en anglais)
+> - Prefixes de commits: `feat:`, `fix:`, `chore:`, `docs:`, etc. (Conventional Commits)
+> - Structure GitFlow (worktrees, config, etc.)
+
+| Parametre | Description | Defaut |
+|-----------|-------------|--------|
+| `code` | Code langue (en, fr) | `en` |
+| `descriptions` | Verbes d'action pour suggestions | voir ci-dessous |
+
+**Verbes d'action suggeres par langue:**
+
+| Action | English | Francais |
+|--------|---------|----------|
+| Ajouter | `add` | `ajouter` |
+| Modifier | `update` | `modifier` |
+| Corriger | `fix` | `corriger` |
+| Refactorer | `refactor` | `refactorer` |
+| Supprimer | `remove` | `supprimer` |
+| Ameliorer | `improve` | `ameliorer` |
+| Implementer | `implement` | `implementer` |
+
+**Exemples concrets:**
+
+| Element | English (code: "en") | Francais (code: "fr") |
+|---------|---------------------|----------------------|
+| Branche feature | `feature/add-user-auth` | `feature/ajouter-auth-utilisateur` |
+| Branche hotfix | `hotfix/fix-login-bug` | `hotfix/corriger-bug-login` |
+| Commit | `feat: add user authentication` | `feat: ajouter authentification` |
+| Titre PR | `feat: Add User Auth` | `feat: Ajouter Auth Utilisateur` |
+
+> Note: Le prefix `feature/` et `feat:` restent TOUJOURS en anglais.
+
+La section `naming` configure la normalisation automatique des noms.
+
+| Parametre | Description | Defaut |
+|-----------|-------------|--------|
+| `normalize` | Activer la normalisation automatique | `true` |
+| `maxLength` | Longueur max des noms de branches | `50` |
+| `separator` | Separateur entre les mots | `-` |
+| `lowercase` | Forcer en minuscules | `true` |
+| `removeAccents` | Supprimer les accents | `true` |
+| `allowedChars` | Caracteres autorises (regex) | `a-z0-9-` |
+
+**Fonction de normalisation (utilisee partout):**
+
+```bash
+normalize_name() {
+  local input="$1"
+  local max_length="${2:-50}"
+
+  # 1. Convertir en minuscules
+  local result=$(echo "$input" | tr '[:upper:]' '[:lower:]')
+
+  # 2. Supprimer les accents
+  result=$(echo "$result" | sed 'y/àâäéèêëïîôùûüç/aaaeeeeiioouuc/')
+
+  # 3. Remplacer les espaces et underscores par des tirets
+  result=$(echo "$result" | sed 's/[ _]/-/g')
+
+  # 4. Supprimer les caracteres speciaux (garder uniquement a-z, 0-9, -)
+  result=$(echo "$result" | sed 's/[^a-z0-9-]//g')
+
+  # 5. Supprimer les tirets multiples
+  result=$(echo "$result" | sed 's/--*/-/g')
+
+  # 6. Supprimer les tirets en debut/fin
+  result=$(echo "$result" | sed 's/^-//;s/-$//')
+
+  # 7. Tronquer a la longueur max
+  result=$(echo "$result" | cut -c1-$max_length)
+
+  # 8. Supprimer le tiret final apres troncature
+  result=$(echo "$result" | sed 's/-$//')
+
+  echo "$result"
+}
+
+# Exemples:
+# "Ajouter l'authentification utilisateur" → "ajouter-lauthentification-utilisateur"
+# "Fix: Bug dans le login !!" → "fix-bug-dans-le-login"
+# "Ajout_Feature_Test" → "ajout-feature-test"
+```
+
+---
+
 ### Azure DevOps Configuration (NEW in v1.4)
 
 La section `azureDevOps` configure l'integration avec Azure DevOps CLI pour les PR, work items et boards:

package/templates/commands/gitflow/10-start.md

@@ -12,6 +12,14 @@ Tu es expert GitFlow. Cree une branche dans un **worktree separe** (par defaut).
 
 **Argument:** `$ARGUMENTS` = `{type} {name} [--no-worktree]`
 
+**FLUX D'EXECUTION:**
+```
+AVEC arguments:     ETAPE 1 → ETAPE 5 → ETAPE 6 → ETAPE 7 → ETAPE 8
+SANS arguments:     ETAPE 1 → ETAPE 2 → ETAPE 3 → ETAPE 4 → ETAPE 5 → ETAPE 6 → ETAPE 7 → ETAPE 8
+                                                            ↑
+                                                   TOUJOURS OBLIGATOIRE
+```
+
 ---
 
 ## ETAPE 1: Analyser le contexte
@@ -77,14 +85,16 @@ EF CORE (si projet .NET)
 
 ## ETAPE 3: Questions dynamiques selon contexte
 
-### Si `$ARGUMENTS` fourni → Parser et executer directement
+### Si `$ARGUMENTS` fourni → Parser et aller aux verifications
 
 ```
 $ARGUMENTS = "feature add-user-auth"
 → TYPE = "feature", NAME = "add-user-auth"
-→ Sauter les questions, executer directement
+→ Sauter les questions (ETAPES 3-4), aller directement a ETAPE 5 (verifications)
 ```
 
+**IMPORTANT:** Meme avec des arguments, tu DOIS executer l'ETAPE 5 (verifications) avant de creer la branche.
+
 ### Si PAS d'arguments → Questionnaire dynamique
 
 **Construire les options selon le contexte:**
@@ -148,22 +158,132 @@ AskUserQuestion({
 
 ### Si FEATURE selectionne:
 
+**Lire la configuration de langue:**
+
+```bash
+# ═══════════════════════════════════════════════════════════════
+# CONFIGURATION DE LANGUE
+# ═══════════════════════════════════════════════════════════════
+CONFIG_FILE=".claude/gitflow/config.json"
+LANG_CODE="en"
+if [ -f "$CONFIG_FILE" ]; then
+  LANG_CODE=$(grep -oP '"code":\s*"\K[^"]+' "$CONFIG_FILE" 2>/dev/null | head -1)
+  LANG_CODE=${LANG_CODE:-en}
+fi
+echo "Langue configuree: $LANG_CODE"
+```
+
+**Demander la description selon la langue configuree:**
+
+> **NOTE:** Le prefix `feature/` reste TOUJOURS en anglais.
+> Seule la partie descriptive (apres `feature/`) utilise la langue configuree.
+
 ```javascript
+// Lire la config de langue
+const langConfig = readConfig()?.language || { code: "en" }
+const isEnglish = langConfig.code === "en"
+
+// Suggestions de verbes d'action selon la langue
+// Le prefix de branche "feature/" ne change PAS
+const featureOptions = isEnglish ? [
+  { label: "add-", description: "Add a new feature → feature/add-..." },
+  { label: "update-", description: "Update existing → feature/update-..." },
+  { label: "fix-", description: "Fix a bug → feature/fix-..." },
+  { label: "refactor-", description: "Refactor code → feature/refactor-..." },
+  { label: "improve-", description: "Improve perf/UX → feature/improve-..." }
+] : [
+  { label: "ajouter-", description: "Nouvelle fonctionnalite → feature/ajouter-..." },
+  { label: "modifier-", description: "Modifier existant → feature/modifier-..." },
+  { label: "corriger-", description: "Corriger un bug → feature/corriger-..." },
+  { label: "refactorer-", description: "Refactorer du code → feature/refactorer-..." },
+  { label: "ameliorer-", description: "Ameliorer perf/UX → feature/ameliorer-..." }
+]
+
 AskUserQuestion({
   questions: [{
-    question: "Decrivez la feature (utilisé pour le nom de branche)",
+    question: isEnglish
+      ? "Describe the feature (branch will be feature/your-description)"
+      : "Decrivez la feature (branche sera feature/votre-description)",
     header: "Feature",
-    options: [
-      { label: "add-", description: "Ajouter une nouvelle fonctionnalite" },
-      { label: "update-", description: "Ameliorer une fonctionnalite existante" },
-      { label: "refactor-", description: "Refactoring de code" }
-    ],
+    options: featureOptions,
     multiSelect: false
   }]
 })
-// Puis demander le nom complet en texte libre
+// L'utilisateur complete via "Other" pour le nom complet
+```
+
+**Normaliser le nom saisi:**
+
+```bash
+# ═══════════════════════════════════════════════════════════════
+# FONCTION DE NORMALISATION DES NOMS DE BRANCHES
+# ═══════════════════════════════════════════════════════════════
+normalize_branch_name() {
+  local input="$1"
+  local max_length="${2:-50}"
+
+  # 1. Convertir en minuscules
+  local result=$(echo "$input" | tr '[:upper:]' '[:lower:]')
+
+  # 2. Supprimer les accents (francais et autres)
+  result=$(echo "$result" | sed 'y/àâäéèêëïîôùûüçœæÀÂÄÉÈÊËÏÎÔÙÛÜÇŒÆ/aaaeeeeiioouucoaAAaEeeeIIOOuucoa/')
+
+  # 3. Remplacer espaces, underscores, apostrophes par des tirets
+  result=$(echo "$result" | sed "s/[ _']/-/g")
+
+  # 4. Supprimer les caracteres non autorises
+  result=$(echo "$result" | sed 's/[^a-z0-9-]//g')
+
+  # 5. Supprimer les tirets multiples
+  result=$(echo "$result" | sed 's/--*/-/g')
+
+  # 6. Supprimer les tirets en debut/fin
+  result=$(echo "$result" | sed 's/^-//;s/-$//')
+
+  # 7. Tronquer a la longueur max
+  result=$(echo "$result" | cut -c1-$max_length)
+
+  # 8. Supprimer le tiret final apres troncature
+  result=$(echo "$result" | sed 's/-$//')
+
+  echo "$result"
+}
+
+# Normaliser le nom fourni par l'utilisateur
+RAW_NAME="$USER_INPUT"
+FEATURE_NAME=$(normalize_branch_name "$RAW_NAME" 50)
+
+# Afficher si normalisation appliquee
+if [ "$RAW_NAME" != "$FEATURE_NAME" ]; then
+  echo ""
+  echo "┌──────────────────────────────────────────────────────────────────────────────┐"
+  echo "│  ℹ️  NOM NORMALISE                                                            │"
+  echo "├──────────────────────────────────────────────────────────────────────────────┤"
+  echo "│  Saisi:      $RAW_NAME"
+  echo "│  Normalise:  $FEATURE_NAME"
+  echo "├──────────────────────────────────────────────────────────────────────────────┤"
+  echo "│  Raisons possibles:                                                          │"
+  echo "│  - Accents supprimes (e→e, a→a)                                              │"
+  echo "│  - Espaces remplaces par tirets                                              │"
+  echo "│  - Caracteres speciaux supprimes                                             │"
+  echo "│  - Majuscules converties en minuscules                                       │"
+  echo "└──────────────────────────────────────────────────────────────────────────────┘"
+fi
+
+BRANCH_NAME="feature/$FEATURE_NAME"
+echo "Branche: $BRANCH_NAME"
 ```
 
+**Exemples de normalisation:**
+
+| Entree utilisateur | Resultat normalise |
+|--------------------|-------------------|
+| "Ajouter l'authentification" | `ajouter-lauthentification` |
+| "Add User Auth !!" | `add-user-auth` |
+| "Améliorer_Performance_API" | `ameliorer-performance-api` |
+| "fix: Bug dans le login" | `fix-bug-dans-le-login` |
+| "FEATURE majuscules" | `feature-majuscules` |
+
 ### Si RELEASE selectionne:
 
 **Etape A: Verifier l'etat de main**
@@ -240,26 +360,62 @@ AskUserQuestion({
 **⚠️ NOTE VERSIONING:** La version sera automatiquement incrementee (PATCH) lors du `/gitflow:11-finish`.
 Exemple: `1.7.1` → `1.7.2`. Pas besoin de faire `npm version patch` manuellement.
 
+**Demander la description selon la langue configuree:**
+
+> **NOTE:** Le prefix `hotfix/` reste TOUJOURS en anglais.
+> Seule la partie descriptive utilise la langue configuree.
+
 ```javascript
+// Lire la config de langue
+const langConfig = readConfig()?.language || { code: "en" }
+const isEnglish = langConfig.code === "en"
+
+// Suggestions selon la langue (prefix hotfix/ ne change pas)
+const hotfixOptions = isEnglish ? [
+  { label: "fix-", description: "Bug fix → hotfix/fix-..." },
+  { label: "security-", description: "Security fix → hotfix/security-..." },
+  { label: "revert-", description: "Revert a change → hotfix/revert-..." },
+  { label: "patch-", description: "Quick patch → hotfix/patch-..." }
+] : [
+  { label: "corriger-", description: "Correction bug → hotfix/corriger-..." },
+  { label: "securite-", description: "Correction securite → hotfix/securite-..." },
+  { label: "annuler-", description: "Annuler changement → hotfix/annuler-..." },
+  { label: "patch-", description: "Correctif rapide → hotfix/patch-..." }
+]
+
 AskUserQuestion({
   questions: [{
-    question: "Decrivez le hotfix (utilisé pour le nom de branche)",
+    question: isEnglish
+      ? "Describe the hotfix (branch will be hotfix/your-description)"
+      : "Decrivez le hotfix (branche sera hotfix/votre-description)",
     header: "Hotfix",
-    options: [
-      { label: "fix-", description: "Correction de bug" },
-      { label: "security-", description: "Correction de securite" },
-      { label: "revert-", description: "Annuler un changement" }
-    ],
+    options: hotfixOptions,
     multiSelect: false
   }]
 })
-// Puis demander le nom complet en texte libre
+```
+
+**Normaliser le nom (meme fonction que feature):**
+
+```bash
+# Utiliser la meme fonction normalize_branch_name definie plus haut
+RAW_NAME="$USER_INPUT"
+HOTFIX_NAME=$(normalize_branch_name "$RAW_NAME" 50)
+
+if [ "$RAW_NAME" != "$HOTFIX_NAME" ]; then
+  echo "Nom normalise: '$RAW_NAME' → '$HOTFIX_NAME'"
+fi
+
+BRANCH_NAME="hotfix/$HOTFIX_NAME"
+echo "Branche: $BRANCH_NAME"
 ```
 
 ---
 
 ## ETAPE 5: Verifications pre-creation
 
+> **OBLIGATOIRE:** Cette etape doit TOUJOURS etre executee, meme quand des arguments sont fournis via `$ARGUMENTS`. Ne JAMAIS sauter cette etape.
+
 | Check | Commande | Action si echec |
 |-------|----------|-----------------|
 | Working tree clean | `git status --porcelain` | Proposer stash ou commit |

package/templates/commands/gitflow/11-finish.md

@@ -22,6 +22,39 @@ Tu es expert GitFlow. Finalise une branche apres merge de la PR.
 
 ---
 
+## ETAPE 0: SYNCHRONISATION AVEC REMOTE
+
+> **CRITIQUE:** Toujours synchroniser avec le remote avant toute opération de finish.
+
+```bash
+echo "Synchronisation avec remote..."
+git fetch --all --quiet
+
+# Vérifier l'état de synchronisation des branches principales
+echo ""
+echo "État des branches principales:"
+
+# Vérifier develop
+DEVELOP_BEHIND=$(git rev-list --count develop..origin/develop 2>/dev/null || echo "?")
+DEVELOP_AHEAD=$(git rev-list --count origin/develop..develop 2>/dev/null || echo "?")
+echo "  develop: AHEAD=$DEVELOP_AHEAD, BEHIND=$DEVELOP_BEHIND"
+
+# Vérifier main
+MAIN_BEHIND=$(git rev-list --count main..origin/main 2>/dev/null || echo "?")
+MAIN_AHEAD=$(git rev-list --count origin/main..main 2>/dev/null || echo "?")
+echo "  main:    AHEAD=$MAIN_AHEAD, BEHIND=$MAIN_BEHIND"
+
+# Avertissement si branches principales non synchronisées
+if [ "$DEVELOP_BEHIND" != "0" ] && [ "$DEVELOP_BEHIND" != "?" ]; then
+  echo "⚠️ develop est en retard de $DEVELOP_BEHIND commit(s) - sera mis à jour automatiquement"
+fi
+if [ "$MAIN_BEHIND" != "0" ] && [ "$MAIN_BEHIND" != "?" ]; then
+  echo "⚠️ main est en retard de $MAIN_BEHIND commit(s) - sera mis à jour automatiquement"
+fi
+```
+
+---
+
 ## ETAPE 1: SCAN PROACTIF (si pas d'argument)
 
 > **COMPORTEMENT PROACTIF:** Si aucun argument fourni, scanner TOUTES les branches pour proposer celles qui sont pretes a finaliser.
@@ -29,7 +62,7 @@ Tu es expert GitFlow. Finalise une branche apres merge de la PR.
 ### 1.1 Scanner toutes les branches GitFlow
 
 ```bash
-git fetch --all --quiet
+# Note: git fetch déjà effectué dans ETAPE 0
 
 # Lister toutes les branches feature/release/hotfix
 FEATURES=$(git branch -r | grep 'origin/feature/' | sed 's|origin/||' | tr -d ' ')