repowarden 0.0.0-stage → 4.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SimBienvenueHoulBoumi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,104 @@
-# Temporary Holding Version
+# repowarden
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/SimBienvenueHoulBoumi/repowarden/actions/workflows/ci.yml/badge.svg)](https://github.com/SimBienvenueHoulBoumi/repowarden/actions/workflows/ci.yml)
+[![e2e](https://github.com/SimBienvenueHoulBoumi/repowarden/actions/workflows/e2e.yml/badge.svg)](https://github.com/SimBienvenueHoulBoumi/repowarden/actions/workflows/e2e.yml)
+[![Release](https://img.shields.io/github/v/release/SimBienvenueHoulBoumi/repowarden)](https://github.com/SimBienvenueHoulBoumi/repowarden/releases)
+[![npm](https://img.shields.io/npm/v/repowarden)](https://www.npmjs.com/package/repowarden)
+[![Documentation](https://img.shields.io/badge/docs-site-indigo)](https://simbienvenuehoulboumi.github.io/repowarden/)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/SimBienvenueHoulBoumi/repowarden/badge)](https://scorecard.dev/viewer/?uri=github.com/SimBienvenueHoulBoumi/repowarden)
+[![Licence MIT](https://img.shields.io/badge/licence-MIT-blue)](LICENSE)
+
+**repowarden** garde l'entrée de vos dépôts Git : messages de commit, nommage des branches, secrets, formatage et tests, **quel que soit le langage** — sur les postes (hooks), en CI (GitHub, GitLab) et côté serveur.
+
+📖 **Documentation : https://simbienvenuehoulboumi.github.io/repowarden/** · 🇬🇧 **English: https://simbienvenuehoulboumi.github.io/repowarden/en/**
+
+> **v4 : repogarde devient repowarden** (paquet npm `repowarden`) et lefthook n'est plus pris en charge. Les anciens noms restent lus en v4. Marche à suivre : [Passer à la v4](https://simbienvenuehoulboumi.github.io/repowarden/migration-v4/).
+
+## Ce qu'il fait
+
+- **Commits** : Conventional Commits imposés, préfixe déduit de la branche ; assistant interactif `git cc` (en-tête, corps, pied).
+- **Branches** : format `<type>/<sujet>`, commande de renommage proposée, branches mergées supprimées automatiquement.
+- **Secrets** : gitleaks avant le commit et en CI.
+- **Formatage** : seul le contenu stagé, avec l'outil du projet ; le travail en cours est préservé.
+- **Tests** : au push et en CI, seulement les projets touchés, sur le commit poussé.
+- **Code mort** : seul le nouveau code mort est signalé, prouvé (bloquant) ou candidat (à vérifier) ; `repowarden code-mort` en local.
+- **Tickets** : chaque PR est reliée à un ticket validé (créé automatiquement s'il manque), suivi de « à valider » à « done » à la release ; `repowarden tickets init`.
+- **Versions et releases** : les commits étant conventionnels, la version suivante (semver) et le changelog se déduisent de l'historique ; un workflow réutilisable en fait des releases automatiques (PR de release validée par la CI puis mergée, tag, release), sans jeton ni intervention.
+
+**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://simbienvenuehoulboumi.github.io/repowarden/technologies/). Linux, macOS, Windows.
+
+## 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
+```
+
+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`.
+
+```bash
+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
+```
+
+| Action | Commande |
+|---|---|
+| É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) |
+| 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/SimBienvenueHoulBoumi/repowarden.git ~/repowarden && ~/repowarden/install.sh --global` (mise à jour : `git -C ~/repowarden pull`).
+
+**Tester la prochaine version** (avant sa sortie en production) : `npm install -g repowarden@next`, ou `uses: SimBienvenueHoulBoumi/repowarden@develop` en CI. Retour à la version stable : `npm install -g repowarden@latest`. Les problèmes se signalent en [issue](https://github.com/SimBienvenueHoulBoumi/repowarden/issues).
+
+### 2. Dans un projet d'équipe : les mêmes règles pour tous
+
+Chaque personne de l'équipe installe repowarden une fois sur son poste (partie 1). Le projet, lui, ajoute deux fichiers, à copier depuis [`templates/project/`](templates/project) :
+
+| Fichier | Rôle |
+|---|---|
+| [`.github/workflows/repowarden.yml`](templates/project/.github/workflows/repowarden.yml) | la CI refait toutes les vérifications sur chaque PR : c'est elle qui fait foi, même si quelqu'un contourne les hooks (`git commit --no-verify`) |
+| [`.repowarden.conf`](templates/project/.repowarden.conf) | réglages communs à toute l'équipe, dont la version minimale de repowarden attendue sur les postes |
+
+L'essentiel des deux fichiers :
+
+```yaml
+# .github/workflows/repowarden.yml : vérifications de la PR (dernière version 4.x)
+- uses: SimBienvenueHoulBoumi/repowarden@v4
+  with: { strict: true }      # un outil manquant fait échouer la CI
+```
+
+```ini
+# .repowarden.conf : un poste en retard est prévenu, avec la commande de mise à jour
+[repowarden]
+    version = 3
+```
+
+Puis rendre la CI obligatoire pour merger : `repowarden proteger` (protection de `main`, check `repowarden` exigé).
+
+Exemple complet : [repowarden-demo](https://github.com/SimBienvenueHoulBoumi/repowarden-demo) · Releases automatiques : [documentation](https://simbienvenuehoulboumi.github.io/repowarden/releases/).
+
+### 3. Contribuer à repowarden
+
+```bash
+git clone https://github.com/SimBienvenueHoulBoumi/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
+```
+
+Les PR visent `develop` ; `main` ne reçoit que les livraisons, qui déclenchent les releases. Voir [CONTRIBUTING.md](CONTRIBUTING.md).
+
+**Dans VS Code** : l'extension [repowarden-vscode](https://github.com/SimBienvenueHoulBoumi/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/SimBienvenueHoulBoumi/repowarden-vscode/releases), puis `code --install-extension repowarden-X.Y.Z.vsix`.
+
+## Liens
+
+[Démarrage rapide](https://simbienvenuehoulboumi.github.io/repowarden/demarrage/) · [Hooks et règles](https://simbienvenuehoulboumi.github.io/repowarden/hooks/) · [Technologies](https://simbienvenuehoulboumi.github.io/repowarden/technologies/) · [Configuration](https://simbienvenuehoulboumi.github.io/repowarden/configuration/) · [CI](https://simbienvenuehoulboumi.github.io/repowarden/ci/) · [Versions et releases](https://simbienvenuehoulboumi.github.io/repowarden/releases/) · [Validation humaine](https://simbienvenuehoulboumi.github.io/repowarden/validation/) · [Code mort](https://simbienvenuehoulboumi.github.io/repowarden/code-mort/) · [En organisation](https://simbienvenuehoulboumi.github.io/repowarden/industrialisation/) · [Sources internes (Nexus, Artifactory)](https://simbienvenuehoulboumi.github.io/repowarden/industrialisation/#8-sources-internes-reseau-ferme-nexus-artifactory) · [Désinstallation](https://simbienvenuehoulboumi.github.io/repowarden/desinstallation/) · [Sécurité](SECURITY.md) · [Contribuer](CONTRIBUTING.md) · [Changelog](CHANGELOG.md)
+
+Licence [MIT](LICENSE).

package/bin/code-mort

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# Code mort introduit par ta branche, comme en CI : seules les lignes ajoutées ou
+# modifiées depuis la base comptent (commits, modifications en cours, nouveaux fichiers).
+#   bin/code-mort [base]     défaut : point de départ de la branche depuis origin/main
+# Voir docs/code-mort.md : ce qui est prouvé (bloquant) et ce qui est candidat.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"
+# shellcheck source=../hooks/lib/common.sh
+source "$ROOT/hooks/lib/common.sh"
+# shellcheck source=../hooks/lib/lang.sh
+source "$ROOT/hooks/lib/lang.sh"
+cd "$GIT_TOPLEVEL"
+
+base="${1:-}"
+label="$base"
+if [ -z "$base" ]; then
+    default="$(git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null || echo origin/main)"
+    label="$default"
+    base="$(git merge-base HEAD "$default" 2>/dev/null || git rev-list --max-parents=0 HEAD | tail -n1)"
+fi
+t dc.section
+printf "\n%s━━ %s ━━%s\n" "$UI_B" "$REPLY" "$UI_N"
+changed="$({
+    git diff --name-only --diff-filter=ACMR "$base"
+    git ls-files --others --exclude-standard
+} | sort -u | without_excluded)"
+# Rien de modifié (ex. sur main à jour) : le dire, plutôt que « aucun langage »
+if [ -z "$changed" ]; then
+    info_t dc.no_changes "$label"
+    exit 0
+fi
+deadcode_projects "$base" <<<"$changed"

package/bin/commit

@@ -0,0 +1,412 @@
+#!/usr/bin/env bash
+# Assistant de commit conventionnel : guide l'en-tête, le corps et le pied.
+#   git cc [options de git commit]     alias installé par install.sh
+#   bin/commit --dry-run               affiche le message sans commiter
+#   git cc --strict                    une réponse refusée arrête tout (scripts :
+#                                      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"]
+#                                      sans question (scripts, agents) : mêmes
+#                                      contrôles, toute réponse refusée arrête
+#                                      tout ; type et scope déduits de la
+#                                      branche s'ils sont omis
+# Les réponses sont lues sur l'entrée standard (terminal avec édition de
+# ligne, ou fichier/tube pour les tests). Le commit passe ensuite par les
+# hooks habituels. Couleurs désactivables : NO_COLOR=1.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"
+# shellcheck source=../hooks/lib/common.sh
+source "$ROOT/hooks/lib/common.sh"
+# shellcheck source=../hooks/lib/tickets.sh
+source "$ROOT/hooks/lib/tickets.sh"
+
+# Charte visuelle commune (hooks/lib/ui.sh, chargée par common.sh)
+B="$UI_B" D="$UI_D" G="$UI_G" R="$UI_R" C="$UI_C" N="$UI_N"
+STEPS=5
+
+# Sans question (BATCH) : ni étapes ni aides, seulement les erreurs et l'aperçu
+etape() { [ -z "$BATCH" ] || return 0; printf '\n%s◇ %s/%s%s  %s%s%s\n' "$C" "$1" "$STEPS" "$N" "$B" "$2" "$N" >&2; }
+hint() { [ -z "$BATCH" ] || return 0; printf '  %s%s%s\n' "$D" "$*" "$N" >&2; }
+fail() { printf '  %s✖ %s%s\n' "$R" "$*" "$N" >&2; }
+# Réponse refusée : la question est reposée ; avec --strict, abandon (rien
+# n'est commité) plutôt que de lire la réponse suivante d'un script
+refuse() {
+    fail "$1"
+    [ -z "$STRICT" ] || { t cc.strict_abort; fail "$REPLY"; exit 1; }
+}
+
+# Réponse dans REPLY, nettoyée : séquences d'échappement (flèches, Échap) et
+# caractères de contrôle retirés, espaces de début et de fin supprimés.
+# Dans un terminal, édition de ligne (flèches, effacement) avec read -e.
+# Sans question (BATCH) : la réponse est ANSWER, fixée par l'appelant.
+ask() {
+    if [ -n "$BATCH" ]; then
+        REPLY="$ANSWER"
+    elif [ -t 0 ]; then
+        # Ctrl+D (fin de saisie) : abandon
+        IFS= read -e -r -p "$1" REPLY || { echo >&2; t cc.aborted; fail "$REPLY"; exit 1; }
+    else
+        printf '%s' "$1" >&2
+        # Fin de la saisie (entrée épuisée) : abandon, jamais de boucle infinie
+        if ! IFS= read -r REPLY; then
+            [ -n "$REPLY" ] || { echo >&2; t cc.aborted; fail "$REPLY"; exit 1; }
+        fi
+    fi
+    REPLY="$(printf '%s' "$REPLY" | LC_ALL=C sed -e $'s/\x1b\\[[0-9;?]*[ -\\/]*[@-~]//g' -e $'s/\x1b.//g' |
+        LC_ALL=C tr -d '\000-\010\013-\037\177')"
+    REPLY="${REPLY#"${REPLY%%[![:space:]]*}"}"
+    REPLY="${REPLY%"${REPLY##*[![:space:]]}"}"
+}
+
+# Question oui/non : $1 invite, $2 réponse par défaut (o ou n). Toute autre
+# réponse est refusée et la question reposée. Résultat : YN=1 pour oui.
+ask_yn() {
+    while :; do
+        ask "$1"
+        case "${REPLY:-$2}" in
+            o | O | oui | Oui | OUI | y | Y | yes | Yes | YES) YN=1; return 0 ;;
+            n | N | non | Non | NON | no | No | NO) YN=""; return 0 ;;
+        esac
+        t cc.yn_invalid
+        refuse "$REPLY"
+    done
+}
+
+DRY_RUN="" STRICT="" BATCH="" ANSWER=""
+PASS=() # options transmises à git commit (--no-verify…)
+OPT_TYPE="" OPT_SCOPE="" OPT_MESSAGE="" OPT_BODY="" OPT_REFS="" OPT_BREAKING=""
+# Valeur d'une option : « --type feat » ou « --type=feat »
+option_value() {
+    case "$1" in
+        *=*) REPLY="${1#*=}"; SHIFT=1 ;;
+        *)
+            [ $# -ge 2 ] || { t cc.option_value "$1"; fail "$REPLY"; exit 1; }
+            REPLY="$2"; SHIFT=2
+            ;;
+    esac
+}
+while [ $# -gt 0 ]; do
+    SHIFT=1
+    case "$1" in
+        --dry-run) DRY_RUN=1 ;;
+        --strict) STRICT=1 ;;
+        --type | --type=*) option_value "$@"; OPT_TYPE="$REPLY"; BATCH=1 ;;
+        --scope | --scope=*) option_value "$@"; OPT_SCOPE="$REPLY"; BATCH=1 ;;
+        -m | --message | --message=*) option_value "$@"; OPT_MESSAGE="$REPLY"; BATCH=1 ;;
+        --body | --body=*) option_value "$@"; OPT_BODY="$REPLY"; BATCH=1 ;;
+        --refs | --refs=*) option_value "$@"; OPT_REFS="$REPLY"; BATCH=1 ;;
+        --breaking | --breaking=*) option_value "$@"; OPT_BREAKING="$REPLY"; BATCH=1 ;;
+        --) shift; PASS+=("$@"); break ;;
+        *) PASS+=("$1") ;;
+    esac
+    shift "$SHIFT"
+done
+# Sans question : les valeurs viennent des options, aucune n'est redemandée
+if [ -n "$BATCH" ]; then
+    STRICT=1
+    [ -n "$OPT_MESSAGE" ] || { t cc.batch_message_required; fail "$REPLY"; exit 1; }
+fi
+
+if [ -z "$DRY_RUN" ] && git diff --cached --quiet; then
+    t cc.nothing_staged
+    fail "$REPLY"
+    exit 1
+fi
+
+TYPES=(feat fix docs style refactor perf test build ci chore revert)
+# Emojis à la gitmoji : repères visuels du menu, jamais écrits dans le message
+EMOJIS=(✨ 🐛 📝 🎨 ♻️ ⚡ ✅ 📦 👷 🔧 ⏪)
+DESCRIPTIONS=()
+for _type in "${TYPES[@]}"; do
+    t "cc.type.$_type"
+    DESCRIPTIONS+=("$REPLY")
+done
+
+# Valeurs proposées d'après la branche : feat/panier → feat, panier. Branche
+# hors convention (wip/xyz, essai/xyz) : rien n'est proposé, le type doit être
+# choisi (Entrée donnerait sinon un feat, donc une version mineure, par erreur).
+branch="$(git symbolic-ref --short HEAD 2>/dev/null || echo "")"
+first_commit=""
+git rev-parse -q --verify HEAD >/dev/null || first_commit=1
+default_type="feat"
+default_scope=""
+if [[ "$branch" == */* ]]; then
+    prefix="${branch%%/*}"
+    case "$prefix" in feature) prefix=feat ;; bugfix | hotfix) prefix=fix ;; esac
+    if [[ "$prefix" =~ ^($CC_TYPES)$ ]]; then
+        default_type="$prefix"
+        default_scope="$(echo "${branch#*/}" | tr '[:upper:]/' '[:lower:]-' | tr -cd 'a-z0-9._-')"
+        [ "${#default_scope}" -le 20 ] || default_scope=""
+    else
+        default_type=""
+    fi
+fi
+
+if [ -z "$BATCH" ]; then
+    t cc.title
+    brand "$REPLY" >&2
+    t cc.help
+    printf '%s%s%s\n' "$D" "$REPLY" "$N" >&2
+fi
+
+# 1. Type
+t cc.step1
+etape 1 "$REPLY"
+[ -n "$BATCH" ] || for i in "${!TYPES[@]}"; do
+    printf '  %s%2d%s  %s  %s%-9s%s %s%s%s\n' "$D" "$((i + 1))" "$N" "${EMOJIS[$i]}" "$B" "${TYPES[$i]}" "$N" "$D" "${DESCRIPTIONS[$i]}" "$N" >&2
+done
+while :; do
+    if [ -n "$default_type" ]; then t cc.type_prompt "$default_type"; else t cc.type_prompt_required; fi
+    ANSWER="$OPT_TYPE"
+    ask "$REPLY"
+    answer="${REPLY:-$default_type}"
+    if [ -z "$answer" ]; then
+        t cc.type_required
+        refuse "$REPLY"
+        continue
+    elif [[ "$answer" =~ ^[0-9]+$ ]] && [ "$answer" -ge 1 ] && [ "$answer" -le "${#TYPES[@]}" ]; then
+        type="${TYPES[$((answer - 1))]}"
+        break
+    elif [[ "$answer" =~ ^($CC_TYPES)$ ]]; then
+        type="$answer"
+        break
+    fi
+    t cc.type_invalid "$answer" "${#TYPES[@]}"
+    refuse "$REPLY"
+done
+
+# 2. Scope (optionnel)
+t cc.step2
+etape 2 "$REPLY"
+t cc.scope_hint
+hint "$REPLY"
+while :; do
+    if [ -n "$default_scope" ]; then
+        t cc.scope_prompt_default "$default_scope"
+        ANSWER="$OPT_SCOPE"
+        ask "$REPLY"
+        scope="${REPLY:-$default_scope}"
+        [ "$scope" = - ] && scope=""
+    else
+        t cc.scope_prompt
+        ANSWER="$OPT_SCOPE"
+        ask "$REPLY"
+        scope="$REPLY"
+        [ "$scope" = - ] && scope="" # « - » : aucun scope, comme avec une proposition
+    fi
+    [[ -z "$scope" || "$scope" =~ ^[a-z0-9._-]+$ ]] && break
+    # Version corrigée proposée (« Doc Test » → « doc-test ») : Entrée pour l'accepter
+    fixed="$(printf '%s' "$scope" | tr '[:upper:] ' '[:lower:]-' | LC_ALL=C tr -cd 'a-z0-9._-' | tr -s '-')"
+    fixed="${fixed#-}"
+    fixed="${fixed%-}"
+    if [ -n "$fixed" ]; then
+        t cc.scope_fixed "$fixed"
+        default_scope="$fixed"
+    else
+        t cc.scope_invalid
+    fi
+    refuse "$REPLY"
+done
+
+# Branche protégée (main…) : le commit y serait refusé. On le dit tout de suite
+# et on propose une branche <type>/<scope>, les modifications suivent.
+cfg_r protectedBranches "main master"
+protected="$REPLY" # à garder : skipped réécrit REPLY
+if [ -z "$first_commit" ] && [ -z "$DRY_RUN" ] && ! skipped protect-branch &&
+    [[ " $protected " == *" $branch "* ]]; then
+    t cc.topic_default
+    suggestion="$type/${scope:-$REPLY}"
+    t cc.protected_hint "$branch"
+    printf '\n  %s%s%s\n' "$B" "$REPLY" "$N" >&2
+    while :; do
+        t cc.new_branch_prompt "$suggestion"
+        ANSWER=n # sans question : jamais de branche créée à la place de l'utilisateur
+        ask "$REPLY"
+        name="${REPLY:-$suggestion}"
+        # Réponse incomplète ou approximative : complétée (« feat » → feat/<scope>,
+        # « Mon Test » → feat/mon-test) puis proposée, sans refus sec
+        if [[ "$name" != */* && "$name" =~ ^($CC_TYPES|feature|bugfix|hotfix)$ ]]; then
+            name="$name/${suggestion#*/}"
+        fi
+        case "$name" in n | N | non | no)
+            t cc.aborted
+            printf '%s%s%s\n' "$D" "$REPLY" "$N" >&2
+            exit 1
+            ;;
+        esac
+        if branch_name_valid "$name" && ! git show-ref -q --verify "refs/heads/$name" &&
+            git switch -q -c "$name" </dev/null >/dev/null 2>&1; then
+            branch="$name"
+            t cc.branch_created "$name"
+            hint "$REPLY"
+            break
+        fi
+        if git show-ref -q --verify "refs/heads/$name"; then
+            t cc.branch_exists "$name"
+        else
+            suggestion="$(suggest_branch_name "$name")"
+            t cc.branch_fixed "$name" "$suggestion"
+        fi
+        refuse "$REPLY"
+    done
+fi
+
+# 3. Changement incompatible (version majeure) : sans objet au premier commit
+t cc.step3
+etape 3 "$REPLY"
+breaking=""
+breaking_note=""
+if [ -n "$first_commit" ]; then
+    t cc.first_commit
+    hint "$REPLY"
+else
+    t cc.breaking_hint1
+    hint "$REPLY"
+    t cc.breaking_hint2
+    hint "$REPLY"
+    t cc.breaking_prompt
+    ANSWER="${OPT_BREAKING:+o}"
+    ask_yn "$REPLY" n
+    breaking="$YN"
+    if [ -n "$breaking" ]; then
+        t cc.breaking_note_hint
+        hint "$REPLY"
+        while :; do
+            t cc.breaking_note_prompt
+            ANSWER="$OPT_BREAKING"
+            ask "$REPLY"
+            if [ "${#REPLY}" -ge 10 ] && [[ ! "$REPLY" =~ ^(RAS|ras|rien|aucun|none|-|\.)$ ]]; then
+                breaking_note="$REPLY"
+                break
+            fi
+            t cc.breaking_note_invalid
+            refuse "$REPLY"
+        done
+    fi
+fi
+
+header_prefix="$type${scope:+($scope)}${breaking:+!}: "
+
+# 4. Description, avec contrôle de longueur de l'en-tête
+t cc.step4
+etape 4 "$REPLY"
+authored_length "$header_prefix"
+max=$((72 - REPLY))
+t cc.desc_hint "$max"
+hint "$REPLY"
+while :; do
+    ANSWER="$OPT_MESSAGE"
+    ask "$header_prefix"
+    description="$REPLY"
+    description="${description%.}"
+    if [ -z "$description" ]; then
+        t cc.desc_required
+        refuse "$REPLY"
+        continue
+    fi
+    authored_length "$header_prefix$description"
+    if [ "$REPLY" -gt 72 ]; then
+        t cc.header_too_long "$REPLY"
+        refuse "$REPLY"
+        continue
+    fi
+    break
+done
+
+# 5. Détails (optionnels) : corps puis références
+t cc.step5
+etape 5 "$REPLY"
+t cc.body_hint
+hint "$REPLY"
+body=""
+if [ -n "$BATCH" ]; then
+    [ -z "$OPT_BODY" ] || body="${OPT_BODY%$'\n'}"$'\n'
+fi
+while [ -z "$BATCH" ]; do
+    ask "> "
+    # Ligne vide, ou faite seulement de ponctuation (« ; », « . »…) : fin du corps
+    [[ -n "$REPLY" && ! "$REPLY" =~ ^[[:punct:]]+$ ]] || break
+    body="$body$REPLY"$'\n'
+done
+# Branche type/12-sujet : ticket #12 proposé (Entrée l'accepte, « - » : aucun)
+ticket=""
+branch_ticket_r "$branch"
+[ -z "$REPLY" ] || ticket="Ticket : #$REPLY"
+# Branche de travail sans ticket : prévenu, jamais bloqué. Création proposée
+# seulement si repowarden gère la vie des tickets du projet (et sans -m)
+if [ -z "$ticket" ] && [ -z "$DRY_RUN" ] && ! skipped tickets && work_branch "$branch"; then
+    if [ -z "$BATCH" ] && tickets_managed && has gh; then
+        t cc.ticket_offer
+        ask_yn "$REPLY" n
+        if [ -n "$YN" ] && n="$(bash "$ROOT/bin/ticket" nouveau "$description" --type "$type" --porcelain)" && [ -n "$n" ]; then
+            ticket="Ticket : #$n"
+            t cc.ticket_created "$n"
+            hint "$REPLY"
+        fi
+    else
+        ticket_hint "$branch"
+    fi
+fi
+if [ -n "$ticket" ]; then
+    t cc.refs_prompt_ticket "$ticket"
+else
+    t cc.refs_prompt "$FORGE_REFS"
+fi
+ANSWER="$OPT_REFS"
+ask "$REPLY"
+refs="${REPLY:-$ticket}"
+[ "$refs" != - ] || refs=""
+
+# Message final : en-tête, puis corps et pied séparés par une ligne vide
+footer=""
+[ -z "$breaking_note" ] || footer="BREAKING CHANGE: $breaking_note"$'\n'
+[ -z "$refs" ] || footer="$footer$refs"$'\n'
+message="$header_prefix$description"$'\n'
+[ -z "$body" ] || message="$message"$'\n'"$body"
+[ -z "$footer" ] || message="$message"$'\n'"$footer"
+
+t cc.preview
+printf '\n%s┌─ %s ───────────────────────────────────────────────%s\n' "$D" "$REPLY" "$N" >&2
+while IFS= read -r line; do
+    printf '%s│%s %s\n' "$D" "$N" "$line" >&2
+done <<<"${message%$'\n'}"
+printf '%s└─────────────────────────────────────────────────────────%s\n' "$D" "$N" >&2
+
+if [ -n "$DRY_RUN" ]; then
+    printf '%s' "$message"
+    exit 0
+fi
+
+t cc.confirm
+ANSWER=o
+ask_yn "$REPLY" o
+if [ -z "$YN" ]; then
+    t cc.aborted
+    printf '%s%s%s\n' "$D" "$REPLY" "$N" >&2
+    exit 1
+fi
+
+# Message gardé dans le dépôt si le commit est refusé (hook, secret…) : rien à ressaisir
+file="$(git rev-parse --git-dir)/repowarden-message"
+printf '%s' "$message" >"$file"
+if ! git commit -F "$file" ${PASS[@]+"${PASS[@]}"}; then
+    t cc.kept "$file"
+    printf '\n%s%s%s\n' "$B" "$REPLY" "$N" >&2
+    exit 1
+fi
+rm -f "$file"
+
+# Suite : rappel de la convention de branches
+cfg_r protectedBranches "main master"
+protected="$REPLY"
+t cc.created
+created="$REPLY"
+if [[ " $protected " == *" $branch "* ]]; then
+    t cc.topic
+    t cc.next_branch "${B}git switch -c $type/<$REPLY>$N" "$FORGE_PR"
+else
+    t cc.next_push "${B}git push -u origin $branch$N"
+fi
+printf '\n%s%s✔ %s%s %s\n' "$G" "$B" "$created" "$N" "$REPLY" >&2