FerrFlow suit la spécification Conventional Commits pour déterminer de combien incrémenter la version.

Règles d'incrément

Type de commit	Incrément de version	Exemple
`feat:`	minor	`feat: add wallet subscriptions`
`fix:`	patch	`fix: correct pagination offset`
`perf:`	patch	`perf: cache user queries`
`refactor:`	patch	`refactor: extract auth middleware`
`feat!:` ou `BREAKING CHANGE`	major	`feat!: remove deprecated endpoint`
`chore:`	aucun	`chore: update dependencies`
`docs:`	aucun	`docs: update README`
`ci:`	aucun	`ci: add linting step`
`style:`	aucun	`style: format code`
`test:`	aucun	`test: add unit tests`

Breaking changes

Un breaking change peut être indiqué de deux manières :

Suffixe point d'exclamation :

feat!: remove the /v1/users endpoint
fix!: change authentication header format

Footer BREAKING CHANGE :

feat: redesign the API

BREAKING CHANGE: The /v1/users endpoint has been removed. Use /v2/users instead.

Les deux produisent un incrément major.

Scope

Les scopes sont optionnels et ignorés pour le calcul de l'incrément. Ils sont utiles pour la lisibilité :

feat(auth): add OAuth2 support       → incrément minor
fix(db): correct index on user table  → incrément patch

Pas de release

Les commits de type chore, docs, ci, style ou test ne déclenchent pas de release. Si tous les commits depuis le dernier tag sont de ces types, FerrFlow se termine sans créer de nouvelle version.

Commits multiples

Lorsque plusieurs commits sont présents depuis le dernier tag, FerrFlow prend l'incrément le plus élevé parmi tous :

fix: correct typo       → patch
feat: add export button → minor   ← gagne
chore: lint             → aucun

Résultat : incrément minor.