repowarden 4.7.0 → 4.7.1

package/README.md

@@ -27,29 +27,47 @@
 
 **Plus de 25 technologies** : Java (Maven, Gradle), JavaScript / TypeScript, Python, Go, Rust, PHP, Ruby, .NET, Dart / Flutter, Swift, Elixir, C / C++, Shell, Terraform, Packer, Ansible, Helm, Kubernetes, Docker, GitHub Actions — [détail](https://simdevwarden.github.io/repowarden/technologies/). Linux, macOS, Windows.
 
-## Ce que tu fais à la main
-
-Le reste est automatique. Pas à pas et pièges : [où cliquer](https://simdevwarden.github.io/repowarden/validation/#ou-cliquer).
-
-| Geste | Où |
-|---|---|
-| Valider un ticket | étiquette `validé` (d'office si un mainteneur l'ouvre) |
-| Écrire la conception, avant le code | commentaire contenant « Conception retenue » sur le ticket |
-| Terminer une PR | **Ready for review** : elle se merge seule quand la CI est verte |
-| Livrer en production (flux `develop`) | *Actions → release → Run workflow* (ou la demande du vendredi), puis **Review deployments → Approve and deploy** sur le run |
-| Livrer un correctif urgent | étiquette `urgent` (à créer si absente) sur la PR `fix/…` |
-| Relire une PR, si exigé | *Files changed → Review changes → Approve* |
+## Le cycle d'une modification
+
+De l'idée à la production, chaque changement suit le même chemin. Tu n'agis qu'aux étapes **en gras** ; le reste est automatique, et chaque étape est vérifiée par la CI.
+
+```mermaid
+flowchart LR
+    A[Ticket] -->|validé| B[Conception]
+    B --> C[Branche du ticket]
+    C -->|commits + push| D[PR brouillon]
+    D -->|Ready for review| E{CI verte ?}
+    E -->|oui| F[develop]
+    E -->|non| C
+    F -->|vendredi, ou à la main| G[Demande de livraison]
+    G -->|Approve and deploy| H[main : release]
+```
 
-Une PR `develop` → `main` ouverte à la main ne reçoit jamais d'approbation : lancer le workflow `release`, qui ouvre la sienne.
+| # | Étape | Qui | Ce qui se passe | Statut du ticket |
+|---|---|---|---|---|
+| 1 | Ouvrir un ticket (issue) | toi | rien ne se code sans ticket | à valider |
+| 2 | **Valider le ticket** | toi | étiquette `validé` (posée d'office si un mainteneur ouvre le ticket) | backlog |
+| 3 | **Écrire la conception** | toi | commentaire « Conception retenue » sur le ticket : ce qui change, fichiers touchés, hors périmètre. Sans elle, la vérification `ticket` de la PR échoue | backlog |
+| 4 | **Prendre le ticket** | toi | `repowarden ticket 12` : assigné, branche `fix/12-sujet` créée depuis `develop` | en cours |
+| 5 | Coder et committer | toi | `git cc` ; les hooks vérifient message, branche, secrets, formatage, puis les tests au push | en cours |
+| 6 | Premier push | auto | PR **brouillon** vers `develop` ouverte, titre et description tirés du ticket | en cours |
+| 7 | **Sortir du brouillon** | toi | bouton *Ready for review* (`gh pr ready`) | en relecture |
+| 8 | Vérifier et intégrer | auto | CI complète ; verte → **merge automatique** (squash) dans `develop`. Rouge → corriger et pousser, retour en 5 | préprod |
+| 9 | Préversion | auto | chaque soir si `develop` a changé : `vX.Y.Z-next.N` (paquet `repowarden@next`), pour tester avant la prod | préprod |
+| 10 | Demande de livraison | auto | le vendredi matin, ou à la main (*Actions → release → Run workflow*, ou étiquette `urgent` sur une PR `fix/…`) : instantané `livraison/vX.Y.Z` et sa PR vers `main` | préprod |
+| 11 | **Approuver la livraison** | toi | sur la page du run : **Review deployments → Approve and deploy** (pas « Approve » sur la PR, qui est une simple relecture) | préprod |
+| 12 | Publier | auto | la GitHub App merge vers `main` : tag `vX.Y.Z`, release, paquet npm, documentation | done, ticket fermé |
+
+Seul `develop` entre dans `main`, et jamais sans l'approbation de l'étape 11. Une PR `develop` → `main` ouverte à la main est fermée automatiquement, avec la marche à suivre. Pas à pas, commandes et pièges : [où cliquer](https://simdevwarden.github.io/repowarden/validation/#ou-cliquer).
 
 ## Démarrage
 
 ### 1. Sur ton poste, en une minute (tous tes dépôts)
 
 ```bash
-npm install -g repowarden     # 1. le paquet (yarn global add, pnpm add -g : idem)
-repowarden install --global           # 2. active les hooks : demande la langue, installe git cc
-repowarden                            # 3. vérifie : état du poste et étape suivante
+npm install -g repowarden      # 1. le paquet (yarn global add, pnpm add -g : idem)
+repowarden install --global    # 2. active les hooks : demande la langue, installe git cc
+repowarden                     # 3. vérifie : état du poste et étape suivante
 ```
 
 L'étape 2 est indispensable : par sécurité, le paquet n'exécute rien à l'installation (aucun script `postinstall`, que npm 12 bloque d'ailleurs). Ensuite, dans **n'importe quel dépôt**, les hooks s'appliquent dès le prochain commit. Rien n'est ajouté aux projets ni à leur `package.json`.
@@ -59,7 +77,7 @@ cd mon-projet
 git switch -c feat/panier            # nom de branche vérifié
 git add . && git cc                  # assistant : type, scope, description… puis commit
 git push -u origin feat/panier       # tests des projets touchés avant l'envoi
-repowarden code-mort                  # nouveau code mort de ta branche
+repowarden code-mort                 # nouveau code mort de ta branche
 ```
 
 | Action | Commande |
@@ -67,25 +85,17 @@ repowarden code-mort                  # nouveau code mort de ta branche
 | État du poste, étape suivante | `repowarden` (ou `repowarden statut`) |
 | Toutes les commandes | `repowarden --help` (`cc`, `code-mort`, `proteger`, `npm-publication`…) |
 | Mettre à jour | `npm update -g repowarden` (les hooks suivent) |
+| Tester la prochaine version | `npm install -g repowarden@next` (retour : `repowarden@latest`) ; en CI : `uses: simdevWarden/repowarden@develop` |
 | Désinstaller | `repowarden uninstall --global`, **puis** `npm uninstall -g repowarden` (dans cet ordre : npm n'exécute rien à la désinstallation, les hooks resteraient branchés sur un dossier supprimé) |
 
 Sans Node : `git clone https://github.com/simdevWarden/repowarden.git ~/repowarden && ~/repowarden/install.sh --global` (mise à jour : `git -C ~/repowarden pull`).
 
-### 4. GitHub App pour l'automatisation (merge auto, tickets, releases)
+**Nouvelle machine** : ces trois commandes suffisent. Les règles du dépôt, l'environnement de livraison, la GitHub App, ses secrets et la publication npm vivent sur GitHub et npm : rien à reconfigurer. La clé privée de l'App ne doit jamais se trouver sur un poste.
 
-Pour que les workflows déclenchent les autres workflows (merge auto, tickets, releases), il faut une GitHub App au lieu du `GITHUB_TOKEN` :
-
-```bash
-repowarden app init
-```
-
-1. Ouvre la page locale → clique "Create GitHub App" sur GitHub
-2. Clique "Install" sur ton repo/org
-3. Les secrets `REPOWARDEN_APP_CLIENT_ID` / `REPOWARDEN_APP_KEY` sont configurés automatiquement
-
-Sans cette étape, le `GITHUB_TOKEN` des Actions est utilisé : **ce qu'il fait ne déclenche pas les autres workflows** (merge auto, tickets, préversions).
-
-**Tester la prochaine version** (avant sa sortie en production) : `npm install -g repowarden@next`, ou `uses: simdevWarden/repowarden@develop` en CI. Retour à la version stable : `npm install -g repowarden@latest`. Les problèmes se signalent en [issue](https://github.com/simdevWarden/repowarden/issues).
+> [!NOTE]
+> **GitHub CLI (`gh`) : facultatif.**
+> Sans `gh` : tous les hooks (commits, branches, secrets, formatage, tests), `git cc`, `repowarden code-mort`, `repowarden statut`, et la CI (GitHub ou GitLab), qui n'utilise jamais le `gh` du poste.
+> Avec `gh` connecté (`gh auth login`), en plus : les tickets (`repowarden ticket`, `tickets`, branches de tes tickets créées en local) et la gestion du dépôt (`proteger`, `app init`, `npm-publication`, `pr-*`, `run-*`). Utile au mainteneur du dépôt GitHub ; chaque commande le signale s'il manque.
 
 ### 2. Dans un projet d'équipe : les mêmes règles pour tous
 
@@ -107,22 +117,44 @@ L'essentiel des deux fichiers :
 ```ini
 # .repowarden.conf : un poste en retard est prévenu, avec la commande de mise à jour
 [repowarden]
-    version = 3
+    version = 4
 ```
 
-Puis rendre la CI obligatoire pour merger : `repowarden proteger` (protection de `main`, check `repowarden` exigé).
+Puis rendre la CI obligatoire pour merger (`gh` connecté, admin du dépôt) :
+
+```bash
+repowarden proteger --checks "repowarden,tests"   # toutes les vérifications exigées, séparées par des virgules
+repowarden proteger --checks "repowarden,tests" --verifier   # plus tard : règles en ligne à jour ? (lecture seule)
+```
+
+Toujours passer **toutes** les vérifications à `--checks` : sans lui, seule `repowarden` reste exigée. Avec un flux `develop` → `main`, `proteger` crée aussi l'étiquette `urgent` et exige l'approbation de chaque livraison : utiliser le [modèle de release du flux develop](https://simdevwarden.github.io/repowarden/releases/), sinon `main` attendrait un déploiement que rien ne crée (`proteger` le signale).
 
 Exemple complet : [repowarden-demo](https://github.com/simdevWarden/repowarden-demo) · Releases automatiques : [documentation](https://simdevwarden.github.io/repowarden/releases/).
 
-### 3. Contribuer à repowarden
+### 3. GitHub App pour l'automatisation (merge auto, tickets, releases)
+
+Pour que les workflows déclenchent les autres workflows (merge auto, tickets, releases), il faut une GitHub App au lieu du `GITHUB_TOKEN` :
+
+```bash
+repowarden app init
+```
+
+1. Ouvre la page locale → clique « Create GitHub App » sur GitHub
+2. Clique « Install » sur ton dépôt ou ton organisation
+3. Les secrets `REPOWARDEN_APP_CLIENT_ID` / `REPOWARDEN_APP_KEY` sont configurés automatiquement
+
+Sans cette étape, le `GITHUB_TOKEN` des Actions est utilisé : **ce qu'il fait ne déclenche pas les autres workflows** (merge auto, tickets, préversions).
+
+### 4. Contribuer à repowarden
 
 ```bash
 git clone https://github.com/simdevWarden/repowarden.git && cd repowarden
 ./install.sh                         # repowarden se vérifie lui-même (hooks de ce dépôt)
-bats test/                           # tests (bats-core), aussi lancés au push
+brew install shellcheck bats-core actionlint gitleaks   # outils des vérifications (ou équivalent Linux)
+bats test/                           # tests, aussi lancés au push
 ```
 
-Les PR visent `develop` ; `main` ne reçoit que les livraisons, qui déclenchent les releases. Voir [CONTRIBUTING.md](CONTRIBUTING.md).
+Les PR visent `develop` ; `main` ne reçoit que les livraisons, qui déclenchent les releases. Tout part d'un ticket : voir [AGENTS.md](AGENTS.md) et [CONTRIBUTING.md](CONTRIBUTING.md). Les problèmes se signalent en [issue](https://github.com/simdevWarden/repowarden/issues).
 
 **Dans VS Code** : l'extension [repowarden-vscode](https://github.com/simdevWarden/repowarden-vscode) guide la rédaction des commits, signale une branche mal nommée et des hooks inactifs. En attendant sa publication sur le Marketplace : `.vsix` dans ses [releases](https://github.com/simdevWarden/repowarden-vscode/releases), puis `code --install-extension repowarden-X.Y.Z.vsix`.
 

package/bin/commit

@@ -6,7 +6,7 @@
 #                                      sans cela, la ligne suivante serait lue
 #                                      comme une nouvelle réponse)
 #   git cc -m "description" [--type T] [--scope S] [--breaking NOTE]
-#          [--body TEXTE] [--refs "Closes #12"]
+#          [--body TEXTE] [--refs "Ticket : #12"]
 #                                      sans question (scripts, agents) : mêmes
 #                                      contrôles, toute réponse refusée arrête
 #                                      tout ; type et scope déduits de la
@@ -173,14 +173,19 @@ while :; do
         type="$answer"
         break
     fi
-    t cc.type_invalid "$answer" "${#TYPES[@]}"
+    type_proche_r "$(printf '%s' "$answer" | tr '[:upper:]' '[:lower:]')"
+    if [ -n "$REPLY" ]; then
+        t cc.type_invalid_suggest "$answer" "$REPLY" "${#TYPES[@]}"
+    else
+        t cc.type_invalid "$answer" "${#TYPES[@]}"
+    fi
     refuse "$REPLY"
 done
 
 # 2. Scope (optionnel)
 t cc.step2
 etape 2 "$REPLY"
-t cc.scope_hint
+if [ -n "$default_scope" ]; then t cc.scope_hint_default "$default_scope"; else t cc.scope_hint; fi
 hint "$REPLY"
 while :; do
     if [ -n "$default_scope" ]; then
@@ -352,7 +357,8 @@ fi
 if [ -n "$ticket" ]; then
     t cc.refs_prompt_ticket "$ticket"
 else
-    t cc.refs_prompt "$FORGE_REFS"
+    cfg_r integrationBranch ""
+    if [ -n "$REPLY" ]; then t cc.refs_prompt "Ticket : #12"; else t cc.refs_prompt "$FORGE_REFS"; fi
 fi
 ANSWER="$OPT_REFS"
 ask "$REPLY"

package/hooks/commit-msg

@@ -39,6 +39,30 @@ if [[ "$SUBJECT" =~ ^(Merge|Revert|fixup!|squash!) ]]; then
     exit 0
 fi
 
+# En-tête tenté mais refusé : type inconnu (ou en majuscules), description vide
+if ! [[ "$SUBJECT" =~ $CC_PATTERN ]] &&
+    [[ "$SUBJECT" =~ ^([A-Za-z]+)(\([^\)]*\))?(!?):[[:space:]]*(.*)$ ]]; then
+    typ="${BASH_REMATCH[1]}" portee="${BASH_REMATCH[2]}" bang="${BASH_REMATCH[3]}" desc="${BASH_REMATCH[4]}"
+    typ_min="$(printf '%s' "$typ" | tr '[:upper:]' '[:lower:]')"
+    propose="$typ_min"
+    [[ "$typ_min" =~ ^($CC_TYPES)$ ]] || { type_proche_r "$typ_min"; propose="$REPLY"; }
+    if [ -z "$desc" ]; then
+        err_t hook.commit_msg.desc_empty "${propose:-$typ}$portee$bang:"
+        echo_t hook.commit_msg.kept >&2
+        exit 1
+    fi
+    if [ "$propose" != "$typ" ]; then
+        if [ -n "$propose" ]; then
+            err_t hook.commit_msg.type_unknown "$typ" "$propose$portee$bang: $desc"
+        else
+            err_t hook.commit_msg.type_none "$typ"
+            types_help
+        fi
+        echo_t hook.commit_msg.kept >&2
+        exit 1
+    fi
+fi
+
 if ! [[ "$SUBJECT" =~ $CC_PATTERN ]]; then
     if [ "${REPOWARDEN_LANG:-}" = en ]; then
         cat >&2 <<EOF
@@ -80,6 +104,15 @@ EOF
     exit 1
 fi
 
+# Point final retiré, comme dans git cc (pas des points de suspension) ; seule
+# la première ligne est réécrite, le corps reste intact
+if [[ "$SUBJECT" == *. && "$SUBJECT" != *.. ]]; then
+    SUBJECT="${SUBJECT%.}"
+    contenu="$(awk -v s="$SUBJECT" '!fait && !/^#/ { print s; fait = 1; next } { print }' "$MSG_FILE")"
+    printf '%s\n' "$contenu" >"$MSG_FILE"
+    info_t hook.commit_msg.dot >&2
+fi
+
 authored_length "$SUBJECT"
 if [ "$REPLY" -gt 72 ]; then
     err_t hook.commit_msg.1 "$REPLY" >&2

package/hooks/lib/common.sh

@@ -84,6 +84,23 @@ cfg() {
 CC_TYPES="feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert"
 CC_PATTERN="^($CC_TYPES)(\([a-z0-9._-]+\))?!?: .+"
 
+# Type le plus proche d'un type inconnu : alias courants, puis préfixe commun
+# (doc → docs, feature → feat, Feat → feat) ; vide si aucun
+type_proche_r() {
+    local t="$1" c
+    case "$t" in
+        feature | features) REPLY="feat"; return ;;
+        doc | documentation) REPLY="docs"; return ;;
+        fixe | fixed | fixes | bugfix | hotfix) REPLY="fix"; return ;;
+        tests) REPLY="test"; return ;;
+        refacto | refactoring) REPLY="refactor"; return ;;
+    esac
+    REPLY=""
+    for c in ${CC_TYPES//|/ }; do
+        if [[ "$c" == "$t"* || "$t" == "$c"* ]]; then REPLY="$c"; return; fi
+    done
+}
+
 # REPLY = longueur de la première ligne écrite par l'auteur : le suffixe
 # « (#123) » ajouté par GitHub lors d'un merge squash n'est pas compté.
 authored_length() {

package/hooks/lib/i18n/en.sh

@@ -25,8 +25,10 @@ _msg_en() {
         cc.option_value) _M="Option %s expects a value." ;;
         cc.batch_message_required) _M="Without questions, the description is required: git cc -m \"<description>\" [--type T] [--scope S] [--body …] [--refs …] [--breaking …]." ;;
         cc.type_invalid) _M="\"%s\": pick a number (1 to %s) or a name from the list." ;;
+        cc.type_invalid_suggest) _M="\"%s\": unknown type. Did you mean \"%s\"? Number (1 to %s) or a name from the list." ;;
         cc.step2) _M="Scope (optional)" ;;
         cc.scope_hint) _M="Part of the project affected, e.g. api, auth, chart; Enter for none." ;;
+        cc.scope_hint_default) _M="Part of the project, e.g. api, auth, chart; Enter keeps \"%s\", \"-\" for none." ;;
         cc.scope_prompt_default) _M="Scope (\"-\" for none) [%s]: " ;;
         cc.scope_prompt) _M="Scope: " ;;
         cc.scope_fixed) _M="Scope: lowercase letters, digits, . _ - only. Suggested: %s (Enter to accept)." ;;
@@ -40,7 +42,7 @@ _msg_en() {
         cc.breaking_note_prompt) _M="What changes: " ;;
         cc.breaking_note_invalid) _M="Describe the change (at least 10 characters); otherwise answer no to the previous question." ;;
         cc.step4) _M="Description" ;;
-        cc.desc_hint) _M="Imperative mood, no initial capital or final period; %s characters max." ;;
+        cc.desc_hint) _M="Imperative mood, no final period, lowercase start except acronyms or proper nouns; %s characters max." ;;
         cc.desc_required) _M="The description is required." ;;
         cc.header_too_long) _M="Header too long: %s characters (72 max). Shorten the description." ;;
         cc.step5) _M="Details (optional)" ;;
@@ -48,7 +50,8 @@ _msg_en() {
         cc.refs_prompt_ticket) _M="References (\"-\" for none) [%s]: " ;;
         cc.refs_prompt) _M="References (e.g. %s; Enter for none): " ;;
         tk.cli.no_ticket) _M="Branch %s has no ticket: this work will not be linked to any ticket (not blocking)." ;;
-        tk.cli.propose) _M="Start it from a ticket: repowarden ticket nouveau \"<title>\" (or answer yes in git cc)." ;;
+        tk.cli.propose) _M="Start it from a ticket: repowarden ticket nouveau \"<title>\"." ;;
+        tk.cli.propose_cc) _M="Start it from a ticket: repowarden ticket nouveau \"<title>\" (or answer yes in git cc)." ;;
         tk.cli.silence) _M="Project without ticket tracking? git config repowarden.skip tickets to stop seeing this." ;;
         tk.cli.fetch) _M="Branch of ticket #%s…" ;;
         tk.cli.switched) _M="On branch %s (ticket #%s)." ;;
@@ -111,6 +114,11 @@ _msg_en() {
         hook.pre_commit.6) _M="gitleaks not installed, secret detection skipped (install: %s)." ;;
         hook.pre_commit.7) _M="Pre-commit OK" ;;
         hook.commit_msg.1) _M="First line too long (%s > 72 characters)." ;;
+        hook.commit_msg.type_unknown) _M="Unknown type \"%s\". Did you mean: %s" ;;
+        hook.commit_msg.type_none) _M="Unknown type \"%s\". Possible types:" ;;
+        hook.commit_msg.desc_empty) _M="Missing description after \"%s\": describe the change in the imperative mood." ;;
+        hook.commit_msg.kept) _M="  Your message is not lost: git commit -e -F .git/COMMIT_EDITMSG" ;;
+        hook.commit_msg.dot) _M="Final period removed from the description (same rule as git cc)." ;;
         hook.pre_push.1) _M="Push refused: branch name does not follow the convention." ;;
         hook.pre_push.2) _M="Direct push to '%s' refused: it only changes through pull requests." ;;
         hook.pre_push.3) _M="  Create a branch: git switch -c feat/my-feature, then open a PR." ;;

package/hooks/lib/i18n/fr.sh

@@ -25,8 +25,10 @@ _msg_fr() {
         cc.option_value) _M="L'option %s attend une valeur." ;;
         cc.batch_message_required) _M="Sans question, la description est obligatoire : git cc -m \"<description>\" [--type T] [--scope S] [--body …] [--refs …] [--breaking …]." ;;
         cc.type_invalid) _M="« %s » : choisis un numéro (1 à %s) ou un nom de la liste." ;;
+        cc.type_invalid_suggest) _M="« %s » : type inconnu. Voulais-tu « %s » ? Numéro (1 à %s) ou nom de la liste." ;;
         cc.step2) _M="Scope (optionnel)" ;;
         cc.scope_hint) _M="Partie du projet concernée, ex. api, auth, chart ; Entrée pour aucun." ;;
+        cc.scope_hint_default) _M="Partie du projet concernée, ex. api, auth, chart ; Entrée garde « %s », « - » pour aucun." ;;
         cc.scope_prompt_default) _M="Scope (« - » pour aucun) [%s] : " ;;
         cc.scope_prompt) _M="Scope : " ;;
         cc.scope_fixed) _M="Scope : minuscules, chiffres, . _ - uniquement. Proposé : %s (Entrée pour l'accepter)." ;;
@@ -40,7 +42,7 @@ _msg_fr() {
         cc.breaking_note_prompt) _M="Ce qui change : " ;;
         cc.breaking_note_invalid) _M="Décris le changement (10 caractères au moins) ; sinon, réponds non à la question précédente." ;;
         cc.step4) _M="Description" ;;
-        cc.desc_hint) _M="À l'impératif, sans majuscule initiale ni point final ; %s caractères au plus." ;;
+        cc.desc_hint) _M="À l'impératif, sans point final, minuscule initiale sauf sigle ou nom propre ; %s caractères au plus." ;;
         cc.desc_required) _M="La description est obligatoire." ;;
         cc.header_too_long) _M="En-tête trop long : %s caractères (72 max). Raccourcis la description." ;;
         cc.step5) _M="Détails (optionnels)" ;;
@@ -48,7 +50,8 @@ _msg_fr() {
         cc.refs_prompt_ticket) _M="Références (« - » pour aucune) [%s] : " ;;
         cc.refs_prompt) _M="Références (ex. %s ; Entrée pour aucune) : " ;;
         tk.cli.no_ticket) _M="Branche %s sans ticket : ce travail ne sera relié à aucun ticket (non bloquant)." ;;
-        tk.cli.propose) _M="Le partir d'un ticket : repowarden ticket nouveau \"<titre>\" (ou réponds oui à git cc)." ;;
+        tk.cli.propose) _M="Partir d'un ticket : repowarden ticket nouveau \"<titre>\"." ;;
+        tk.cli.propose_cc) _M="Partir d'un ticket : repowarden ticket nouveau \"<titre>\" (ou réponds oui à git cc)." ;;
         tk.cli.silence) _M="Projet sans suivi de tickets ? git config repowarden.skip tickets pour ne plus le voir." ;;
         tk.cli.fetch) _M="Branche du ticket #%s…" ;;
         tk.cli.switched) _M="Sur la branche %s (ticket #%s)." ;;
@@ -109,6 +112,11 @@ _msg_fr() {
         hook.pre_commit.6) _M="gitleaks absent, détection de secrets ignorée (installation : %s)." ;;
         hook.pre_commit.7) _M="Pre-commit OK" ;;
         hook.commit_msg.1) _M="Première ligne trop longue (%s > 72 caractères)." ;;
+        hook.commit_msg.type_unknown) _M="Type « %s » inconnu. Voulais-tu : %s" ;;
+        hook.commit_msg.type_none) _M="Type « %s » inconnu. Types possibles :" ;;
+        hook.commit_msg.desc_empty) _M="Description manquante après « %s » : décris le changement à l'impératif." ;;
+        hook.commit_msg.kept) _M="  Ton message n'est pas perdu : git commit -e -F .git/COMMIT_EDITMSG" ;;
+        hook.commit_msg.dot) _M="Point final retiré de la description (même règle que git cc)." ;;
         hook.pre_push.1) _M="Push refusé : nom de branche non conforme." ;;
         hook.pre_push.2) _M="Push direct refusé sur '%s' : elle n'évolue que par Pull Request." ;;
         hook.pre_push.3) _M="  Crée une branche : git switch -c feat/ma-feature, puis ouvre une PR." ;;

package/hooks/lib/tickets.sh

@@ -168,7 +168,8 @@ ticket_hint() {
     [ -z "$REPLY" ] || return 0
     attention_t tk.cli.no_ticket "$branch"
     if tickets_managed && has gh; then
-        dim_t tk.cli.propose
+        # git cc ne propose de créer le ticket qu'avec ticketAutoCreate
+        if ticket_auto_create; then dim_t tk.cli.propose_cc; else dim_t tk.cli.propose; fi
     else
         dim_t tk.cli.silence
     fi

package/hooks/lib/ui.sh

@@ -31,7 +31,27 @@ repowarden_version_r() {
     local tag=""
     REPLY="$(sed -n 's/^  "version": *"\([^"]*\)".*/\1/p' "$1/package.json" 2>/dev/null | sed -n 1p)"
     if [ -e "$1/.git" ]; then
-        tag="$(git -C "$1" describe --tags --abbrev=0 --match 'v[0-9]*' 2>/dev/null || true)"
+        # Sous-shell sans les variables que git exporte aux hooks (worktree) :
+        # elles l'emportent sur -C, ce seraient les tags du projet. Tag le plus
+        # proche de HEAD (git describe), remplacé par un tag de release dont le
+        # commit mergé est au moins aussi proche : la release est taguée sur le
+        # merge de la livraison dans main, invisible depuis develop pour
+        # describe ; à égalité, la version stable l'emporte sur la préversion
+        tag="$(
+            unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE GIT_COMMON_DIR
+            best="$(git -C "$1" describe --tags --abbrev=0 --match 'v[0-9]*' 2>/dev/null || true)"
+            dist=""
+            [ -z "$best" ] || dist="$(git -C "$1" rev-list --count "$best..HEAD")"
+            while IFS= read -r t; do
+                git -C "$1" merge-base --is-ancestor "$t^2" HEAD 2>/dev/null || continue
+                d="$(git -C "$1" rev-list --count "$t^2..HEAD")"
+                if [ -z "$best" ] || [ "$d" -lt "$dist" ] ||
+                    { [ "$d" -eq "$dist" ] && [[ "$t" != *-* && "$best" == *-* ]]; }; then
+                    best="$t" dist="$d"
+                fi
+            done < <(git -C "$1" tag --no-merged HEAD --list 'v[0-9]*' 2>/dev/null)
+            echo "$best"
+        )"
         [ -z "$tag" ] || REPLY="${tag#v}"
     fi
 }

package/hooks/prepare-commit-msg

@@ -2,7 +2,7 @@
 # Hook prepare-commit-msg : déduit le préfixe Conventional Commits du nom de branche.
 #   branche feat/bean :  git commit            → éditeur prérempli avec "feat(bean): "
 #                        git commit -m "ajoute X" → "feat(bean): ajoute X"
-# Un message déjà conforme n'est pas modifié.
+# Un message déjà conforme, ou qui a la forme d'un en-tête, n'est pas modifié.
 set -euo pipefail
 
 source "$(dirname "$0")/lib/common.sh"
@@ -36,6 +36,9 @@ fi
 
 SUBJECT="$(grep -v '^#' "$MSG_FILE" | sed -n 1p || true)"
 [[ "$SUBJECT" =~ $CC_PATTERN ]] && exit 0
+# En-tête déjà tenté (mot: ou mot(portée):), même raté : jamais enveloppé,
+# commit-msg le juge (« doc: x » deviendrait « feat(y): doc: x », accepté)
+[[ "$SUBJECT" =~ ^[A-Za-z]+(\([^\)]*\))?!?: ]] && exit 0
 [[ "$SUBJECT" =~ ^(Merge|Revert|fixup!|squash!) ]] && exit 0
 
 # Ajoute le préfixe en tête de la première ligne (vide ou non)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repowarden",
-  "version": "4.7.0",
+  "version": "4.7.1",
   "description": "Hooks git et CI multi-langages : messages de commit, nommage des branches, secrets, formatage, tests ciblés, code mort, releases.",
   "keywords": [
     "git-hooks",