docs : corrige le format de commit dans le plan (commit-msg hook) (MUI-39)

2026-05-27 10:20:56 +02:00
parent c3b018cdc7
commit 23769cdf85
1 changed files with 3 additions and 1 deletions
@@ -8,7 +8,9 @@

 **Tech Stack :** Nuxt 4 layer, Vue 3 `<script setup lang="ts">`, Tailwind (palette `m-*`), `tailwind-merge`, `@iconify/vue`, Vitest + `@vue/test-utils` (jsdom).

-**Conventions de commit :** style historique `[#MUI-39] <description>`. Aucun hook n'est installé actuellement ; si un hook pre-commit/commit-msg flaky se manifeste, relancer ou utiliser `--no-verify` (cf. mémo projet). La suite Date/InputRichText est flaky sous charge → relancer 2-3× avant de conclure à une régression.
+**Conventions de commit :** un hook `commit-msg` (copié depuis `commit-msg` à la racine via `make copy-git-hook`) impose le format **`<type>(<scope minuscule>) : <message>`** — espace AVANT le `:`, type minuscule parmi `build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test`, scope optionnel `[a-z0-9._-]+` (donc **pas de majuscules** : `MUI-39` interdit en scope). Utiliser le scope du dossier (`time`, `date`) et mettre la réf ticket dans le message. Exemples : `feat(time) : ajoute timeFormat (MUI-39)`. ⚠️ Les libellés `[#MUI-39] …` dans les commits ci-dessous sont **descriptifs** : les traduire en format conventionnel à l'exécution.
+
+Le hook `pre-commit` lance `make pre-commit` = `lint` + **toute la suite de tests**, qui est **flaky** (timeouts intermittents dans des fichiers SANS rapport : Accordion, ButtonIcon, InputTextArea, SiteSelector, Date, InputRichText). Si le commit échoue uniquement à cause de ces tests flaky non liés : relancer 1×, sinon `--no-verify` (toléré, cf. mémo). **Ne jamais** utiliser `--no-verify` pour masquer un échec dans un fichier que la tâche vient de créer/modifier, ni un message de commit non conforme.

 **Commandes utiles :**
 - Test ciblé : `npx vitest run <chemin>`