@ferrflow/doc 7.17.0

package/docs-fr-v6/configuration/formats.md

@@ -0,0 +1,150 @@
+---
+title: Formats supportés
+description: Formats de fichiers de version que FerrFlow peut lire et mettre à jour.
+---
+
+## TOML
+
+Utilisé par Rust (`Cargo.toml`) et Python (`pyproject.toml`).
+
+FerrFlow met à jour le champ `version` sous `[package]`, `[project]` ou `[tool.poetry]`.
+
+```toml
+[package]
+name = "my-crate"
+version = "1.2.3"   # ← mis à jour
+```
+
+## JSON
+
+Utilisé par Node.js (`package.json`).
+
+FerrFlow met à jour le champ `version` de premier niveau.
+
+```json
+{
+  "name": "my-package",
+  "version": "1.2.3"
+}
+```
+
+## XML
+
+Utilisé par Java/Maven (`pom.xml`).
+
+FerrFlow met à jour le premier élément `<version>` rencontré.
+
+```xml
+<project>
+  <groupId>com.example</groupId>
+  <artifactId>my-app</artifactId>
+  <version>1.2.3</version>   <!-- mis à jour -->
+</project>
+```
+
+## Gradle
+
+Utilisé par les projets Java/Kotlin Gradle (`build.gradle`, `build.gradle.kts`).
+
+FerrFlow met à jour l'assignation `version = "..."`.
+
+```groovy
+version = "1.2.3"   // mis à jour
+```
+
+## Texte brut
+
+Utilisé pour les fichiers de version simples (`VERSION`, `VERSION.txt`).
+
+FerrFlow remplace l'intégralité du contenu du fichier par le numéro de version.
+
+```
+1.2.3
+```
+
+## Go modules
+
+Utilisé par les projets Go (`go.mod`).
+
+Les modules Go utilisent directement les tags git — FerrFlow ne modifie **pas** `go.mod`. La version est dérivée entièrement du tag git (`v1.2.3` ou `{name}@v1.2.3`).
+
+## Helm
+
+Utilisé par les charts Helm Kubernetes (`Chart.yaml`).
+
+FerrFlow met à jour le champ `version` et, lorsqu'il est présent, maintient `appVersion` synchronisé.
+
+```yaml
+apiVersion: v2
+name: my-app
+version: 1.2.3 # ← mis à jour
+appVersion: '1.2.3' # ← mis à jour si présent
+```
+
+## Cabal
+
+Utilisé par les packages Haskell (`*.cabal`).
+
+FerrFlow met à jour le champ `version` de premier niveau. Le champ `cabal-version`, qui déclare le format du fichier et non la version du package, n'est jamais modifié — pas plus qu'un `version:` indenté à l'intérieur d'une stanza.
+
+```
+cabal-version:      2.4   # ← laissé tel quel
+name:               my-package
+version:            1.2.3 # ← mis à jour
+```
+
+## CMake
+
+Utilisé par les projets C / C++ (`CMakeLists.txt`).
+
+FerrFlow met à jour l'argument `VERSION` de l'appel `project()`, y compris lorsqu'il est réparti sur plusieurs lignes. `cmake_minimum_required(VERSION …)` — la version minimale de l'outil CMake — n'est pas touché.
+
+```cmake
+cmake_minimum_required(VERSION 3.20)   # ← laissé tel quel
+
+project(MyProject
+    VERSION 1.2.3                      # ← mis à jour
+    LANGUAGES CXX)
+```
+
+## Plusieurs fichiers par package
+
+Un package peut avoir autant d'entrées de fichiers versionnés que nécessaire :
+
+<div class="ferr-tabs">
+  <div class="ferr-tab" data-label="JSON"><p class="ferr-tab__label">JSON</p><div class="ferr-tab__body"><pre><code class="language-json">{
+  &quot;package&quot;: [
+    {
+      &quot;versionedFiles&quot;: [
+        { &quot;path&quot;: &quot;Cargo.toml&quot;, &quot;format&quot;: &quot;toml&quot; },
+        { &quot;path&quot;: &quot;npm/package.json&quot;, &quot;format&quot;: &quot;json&quot; }
+      ]
+    }
+  ]
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="TOML"><p class="ferr-tab__label">TOML</p><div class="ferr-tab__body"><pre><code class="language-toml">[[package.versioned_files]]
+path   = &quot;Cargo.toml&quot;
+format = &quot;toml&quot;
+
+[[package.versioned_files]]
+path = &quot;npm/package.json&quot;
+format = &quot;json&quot;
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="JSON5"><p class="ferr-tab__label">JSON5</p><div class="ferr-tab__body"><pre><code class="language-json5">{
+  package: [
+    {
+      versionedFiles: [
+        { path: &quot;Cargo.toml&quot;, format: &quot;toml&quot; },
+        { path: &quot;npm/package.json&quot;, format: &quot;json&quot; },
+      ],
+    },
+  ],
+}
+</code></pre>
+</div></div>
+</div>
+
+Les deux fichiers seront mis à jour avec la même version avant le commit git.

package/docs-fr-v6/configuration/monorepo.md

@@ -0,0 +1,357 @@
+---
+title: Monorepo
+description: Versionner plusieurs packages indépendamment dans un seul repository.
+---
+
+FerrFlow considère un repository comme un monorepo lorsque la configuration définit plus d'un package. Chaque package est versionné indépendamment en fonction de son propre historique git.
+
+## Isolation des packages
+
+FerrFlow utilise les préfixes de chemin pour déterminer quels commits appartiennent à quel package. Seuls les commits qui touchent des fichiers sous `path` (ou `sharedPaths`) déclenchent une release pour ce package.
+
+<div class="ferr-tabs">
+  <div class="ferr-tab" data-label="JSON"><p class="ferr-tab__label">JSON</p><div class="ferr-tab__body"><pre><code class="language-json">{
+  &quot;package&quot;: [
+    {
+      &quot;name&quot;: &quot;api&quot;,
+      &quot;path&quot;: &quot;packages/api&quot;
+    },
+    {
+      &quot;name&quot;: &quot;site&quot;,
+      &quot;path&quot;: &quot;packages/site&quot;
+    }
+  ]
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="TOML"><p class="ferr-tab__label">TOML</p><div class="ferr-tab__body"><pre><code class="language-toml">[[package]]
+name = &quot;api&quot;
+path = &quot;packages/api&quot;
+
+[[package]]
+name = &quot;site&quot;
+path = &quot;packages/site&quot;
+</code></pre>
+
+</div></div>
+  <div class="ferr-tab" data-label="JSON5"><p class="ferr-tab__label">JSON5</p><div class="ferr-tab__body"><pre><code class="language-json5">{
+  package: [
+    {
+      name: &quot;api&quot;,
+      path: &quot;packages/api&quot;,
+    },
+    {
+      name: &quot;site&quot;,
+      path: &quot;packages/site&quot;,
+    },
+  ],
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="YAML"><p class="ferr-tab__label">YAML</p><div class="ferr-tab__body"><pre><code class="language-yaml">package:
+  - name: api
+    path: packages/api
+  - name: site
+    path: packages/site
+</code></pre>
+</div></div>
+</div>
+
+## Dépendances partagées
+
+Si vous avez du code partagé entre packages (ex. une bibliothèque `packages/shared/`), déclarez-le comme entrée `sharedPaths`. Un changement dans un chemin partagé déclenche une release pour chaque package qui le référence :
+
+<div class="ferr-tabs">
+  <div class="ferr-tab" data-label="JSON"><p class="ferr-tab__label">JSON</p><div class="ferr-tab__body"><pre><code class="language-json">{
+  &quot;package&quot;: [
+    {
+      &quot;name&quot;: &quot;api&quot;,
+      &quot;path&quot;: &quot;packages/api&quot;,
+      &quot;sharedPaths&quot;: [&quot;packages/shared/&quot;]
+    },
+    {
+      &quot;name&quot;: &quot;site&quot;,
+      &quot;path&quot;: &quot;packages/site&quot;,
+      &quot;sharedPaths&quot;: [&quot;packages/shared/&quot;]
+    }
+  ]
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="TOML"><p class="ferr-tab__label">TOML</p><div class="ferr-tab__body"><pre><code class="language-toml">[[package]]
+name = &quot;api&quot;
+path = &quot;packages/api&quot;
+shared_paths = [&quot;packages/shared/&quot;]
+
+[[package]]
+name = &quot;site&quot;
+path = &quot;packages/site&quot;
+shared_paths = [&quot;packages/shared/&quot;]
+</code></pre>
+
+</div></div>
+  <div class="ferr-tab" data-label="JSON5"><p class="ferr-tab__label">JSON5</p><div class="ferr-tab__body"><pre><code class="language-json5">{
+  package: [
+    {
+      name: &quot;api&quot;,
+      path: &quot;packages/api&quot;,
+      sharedPaths: [&quot;packages/shared/&quot;],
+    },
+    {
+      name: &quot;site&quot;,
+      path: &quot;packages/site&quot;,
+      sharedPaths: [&quot;packages/shared/&quot;],
+    },
+  ],
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="YAML"><p class="ferr-tab__label">YAML</p><div class="ferr-tab__body"><pre><code class="language-yaml">package:
+  - name: api
+    path: packages/api
+    sharedPaths:
+      - packages/shared/
+  - name: site
+    path: packages/site
+    sharedPaths:
+      - packages/shared/
+</code></pre>
+</div></div>
+</div>
+
+## Dependances entre packages
+
+Utilisez `dependsOn` pour declarer qu'un package depend d'un autre. Quand une dependance est publiee, le package dependant recoit automatiquement un bump patch — meme si aucun de ses propres fichiers n'a change. La cascade est transitive : si `app` depend de `cli` et `cli` depend de `core`, publier `core` bumpe aussi `cli` et `app`.
+
+<div class="ferr-tabs">
+  <div class="ferr-tab" data-label="JSON"><p class="ferr-tab__label">JSON</p><div class="ferr-tab__body"><pre><code class="language-json">{
+  &quot;package&quot;: [
+    {
+      &quot;name&quot;: &quot;core&quot;,
+      &quot;path&quot;: &quot;packages/core&quot;
+    },
+    {
+      &quot;name&quot;: &quot;cli&quot;,
+      &quot;path&quot;: &quot;packages/cli&quot;,
+      &quot;dependsOn&quot;: [&quot;core&quot;]
+    },
+    {
+      &quot;name&quot;: &quot;app&quot;,
+      &quot;path&quot;: &quot;packages/app&quot;,
+      &quot;dependsOn&quot;: [&quot;cli&quot;]
+    }
+  ]
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="TOML"><p class="ferr-tab__label">TOML</p><div class="ferr-tab__body"><pre><code class="language-toml">[[package]]
+name = &quot;core&quot;
+path = &quot;packages/core&quot;
+
+[[package]]
+name = &quot;cli&quot;
+path = &quot;packages/cli&quot;
+depends_on = [&quot;core&quot;]
+
+[[package]]
+name = &quot;app&quot;
+path = &quot;packages/app&quot;
+depends_on = [&quot;cli&quot;]
+</code></pre>
+
+</div></div>
+  <div class="ferr-tab" data-label="JSON5"><p class="ferr-tab__label">JSON5</p><div class="ferr-tab__body"><pre><code class="language-json5">{
+  package: [
+    {
+      name: &quot;core&quot;,
+      path: &quot;packages/core&quot;,
+    },
+    {
+      name: &quot;cli&quot;,
+      path: &quot;packages/cli&quot;,
+      dependsOn: [&quot;core&quot;],
+    },
+    {
+      name: &quot;app&quot;,
+      path: &quot;packages/app&quot;,
+      dependsOn: [&quot;cli&quot;],
+    },
+  ],
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="YAML"><p class="ferr-tab__label">YAML</p><div class="ferr-tab__body"><pre><code class="language-yaml">package:
+  - name: core
+    path: packages/core
+  - name: cli
+    path: packages/cli
+    dependsOn:
+      - core
+  - name: app
+    path: packages/app
+    dependsOn:
+      - cli
+</code></pre>
+</div></div>
+</div>
+
+<aside class="ferr-aside ferr-aside--note"><div class="ferr-aside__body"><p><code>dependsOn</code> est different de <code>sharedPaths</code>. Les chemins partages declenchent un bump quand des fichiers dans le repertoire partage changent. <code>dependsOn</code> declenche un bump quand un autre <strong>package</strong> est publie, independamment des fichiers modifies.</p>
+</div></aside>
+
+### Cycles de dépendances
+
+`dependsOn` doit décrire un graphe orienté acyclique. Si deux packages dépendent l'un de l'autre — directement ou transitivement — il n'existe aucun ordre de release possible : FerrFlow s'arrête alors avec l'erreur `E8003` en nommant la boucle :
+
+```
+cycle detected: api → web → api
+```
+
+La vérification s'exécute avant toute écriture de version : une configuration cyclique ne produit jamais de release partielle. Cassez la boucle en supprimant l'une des arêtes `dependsOn`. Sinon, le graphe est publié dépendances d'abord : un package est toujours publié après les packages dont il dépend.
+
+## Groupes de versions liées et fixes
+
+Parfois, plusieurs packages doivent partager le même numéro de version, pas seulement propager un bump. `linked` et `fixed` listent des groupes de packages qui évoluent ensemble :
+
+```toml
+[workspace]
+linked = [["react", "react-dom"]]
+fixed  = [["@scope/a", "@scope/b", "@scope/c"]]
+```
+
+Dès qu'**un** membre d'un groupe a un commit publiable, tous les membres sont bumpés à la même version — la plus haute que le groupe atteindrait. Un `feat` sur un membre et un `fix` sur un autre publient tout le groupe sur le minor. Les noms de packages restent distincts ; seule la version est partagée, et les membres sans commit propre sont intégrés à la release à la version partagée.
+
+- **`linked`** — les packages partagent une ligne de version lorsqu'ils sont publiés ensemble (par exemple `react` et `react-dom` passent tous deux de `1.2.3` à `1.2.4`).
+- **`fixed`** — les packages sont verrouillés sur une version identique en permanence. Le comportement est celui de `linked`, et `ferrflow validate` avertit en plus lorsque les versions d'un groupe `fixed` ont déjà divergé, pour repérer une édition manuelle avant que la prochaine release ne les réaligne.
+
+Chaque groupe doit lister au moins deux packages, et un package ne peut appartenir qu'à un seul groupe `linked` ou `fixed`. Nommer un package absent de `package[]`, ou en lister un dans deux groupes, arrête la release avec une erreur claire avant toute écriture — la même garantie amont que les [cycles de dépendances](#cycles-de-dépendances).
+
+`linked`/`fixed` et `dependsOn` se combinent : un package qui dépend d'un package groupé reçoit toujours son bump en cascade après l'alignement du groupe.
+
+## Format des tags git
+
+Par défaut, les tags en monorepo utilisent le format `{name}@v{version}` :
+
+```
+api@v1.2.0
+site@v0.4.1
+```
+
+Configurez cela avec le champ `tagTemplate` :
+
+<div class="ferr-tabs">
+  <div class="ferr-tab" data-label="JSON"><p class="ferr-tab__label">JSON</p><div class="ferr-tab__body"><pre><code class="language-json">{
+  &quot;workspace&quot;: {
+    &quot;tagTemplate&quot;: &quot;{name}@v{version}&quot;
+  }
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="TOML"><p class="ferr-tab__label">TOML</p><div class="ferr-tab__body"><pre><code class="language-toml">[workspace]
+tag_template = &quot;{name}@v{version}&quot;
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="JSON5"><p class="ferr-tab__label">JSON5</p><div class="ferr-tab__body"><pre><code class="language-json5">{
+  workspace: {
+    tagTemplate: &quot;{name}@v{version}&quot;,
+  },
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="YAML"><p class="ferr-tab__label">YAML</p><div class="ferr-tab__body"><pre><code class="language-yaml">workspace:
+  tagTemplate: &quot;{name}@v{version}&quot;
+</code></pre>
+</div></div>
+</div>
+
+Pour un repo mono-package, le défaut est `v{version}` (sans préfixe de nom).
+
+FerrFlow recherche le tag le plus récent correspondant au modèle pour déterminer quels commits sont nouveaux.
+
+## Cadences indépendantes
+
+Les packages sont publiés indépendamment. Dans une seule exécution de `ferrflow release` :
+
+- `api` peut passer de `1.2.0` → `1.3.0` (nouveau commit `feat:`)
+- `site` peut passer de `0.4.0` → `0.4.1` (uniquement des commits `fix:`)
+- `shared` peut ne pas être publié (uniquement des commits `chore:`)
+
+## Surcharges par package
+
+Chaque package peut surcharger la stratégie de `versioning` et le `tagTemplate` du workspace :
+
+<div class="ferr-tabs">
+  <div class="ferr-tab" data-label="JSON"><p class="ferr-tab__label">JSON</p><div class="ferr-tab__body"><pre><code class="language-json">{
+  &quot;workspace&quot;: {
+    &quot;versioning&quot;: &quot;semver&quot;,
+    &quot;tagTemplate&quot;: &quot;{name}@v{version}&quot;
+  },
+  &quot;package&quot;: [
+    {
+      &quot;name&quot;: &quot;api&quot;,
+      &quot;path&quot;: &quot;packages/api&quot;,
+      &quot;versioning&quot;: &quot;calver&quot;
+    },
+    {
+      &quot;name&quot;: &quot;site&quot;,
+      &quot;path&quot;: &quot;packages/site&quot;,
+      &quot;tagTemplate&quot;: &quot;site-v{version}&quot;
+    }
+  ]
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="TOML"><p class="ferr-tab__label">TOML</p><div class="ferr-tab__body"><pre><code class="language-toml">[workspace]
+versioning = &quot;semver&quot;
+tag_template = &quot;{name}@v{version}&quot;
+
+[[package]]
+name = &quot;api&quot;
+path = &quot;packages/api&quot;
+versioning = &quot;calver&quot;
+
+[[package]]
+name = &quot;site&quot;
+path = &quot;packages/site&quot;
+tag_template = &quot;site-v{version}&quot;
+</code></pre>
+
+</div></div>
+  <div class="ferr-tab" data-label="JSON5"><p class="ferr-tab__label">JSON5</p><div class="ferr-tab__body"><pre><code class="language-json5">{
+  workspace: {
+    versioning: &quot;semver&quot;,
+    tagTemplate: &quot;{name}@v{version}&quot;,
+  },
+  package: [
+    {
+      name: &quot;api&quot;,
+      path: &quot;packages/api&quot;,
+      versioning: &quot;calver&quot;,
+    },
+    {
+      name: &quot;site&quot;,
+      path: &quot;packages/site&quot;,
+      tagTemplate: &quot;site-v{version}&quot;,
+    },
+  ],
+}
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="YAML"><p class="ferr-tab__label">YAML</p><div class="ferr-tab__body"><pre><code class="language-yaml">workspace:
+  versioning: semver
+  tagTemplate: &quot;{name}@v{version}&quot;
+
+package:
+
+- name: api
+  path: packages/api
+  versioning: calver
+- name: site
+  path: packages/site
+  tagTemplate: &quot;site-v{version}&quot;
+  </code></pre>
+
+</div></div>
+</div>
+
+<aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Utilisez <code>ferrflow check</code> pour prévisualiser exactement quels packages seraient publiés et à quelle version avant de lancer une release.</p>
+</div></aside>

package/docs-fr-v6/installation.md

@@ -0,0 +1,56 @@
+---
+title: Installation
+description: Comment installer FerrFlow en local ou en CI.
+---
+
+## Installation locale
+
+<div class="ferr-tabs">
+  <div class="ferr-tab" data-label="Cargo"><p class="ferr-tab__label">Cargo</p><div class="ferr-tab__body"><pre><code class="language-bash">cargo install ferrflow
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="npm"><p class="ferr-tab__label">npm</p><div class="ferr-tab__body"><pre><code class="language-bash">npm install -g @ferrlabs/ferrflow
+# ou en dépendance de développement
+npm install -D @ferrlabs/ferrflow
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="WASM (navigateur)"><p class="ferr-tab__label">WASM (navigateur)</p><div class="ferr-tab__body"><pre><code class="language-bash">npm install @ferrflow/wasm
+</code></pre>
+<p>Utilisez FerrFlow directement dans le navigateur — parsez les commits, calculez les incréments de version et générez des changelogs côté client sans backend.</p>
+</div></div>
+  <div class="ferr-tab" data-label="Binaire"><p class="ferr-tab__label">Binaire</p><div class="ferr-tab__body"><p>Téléchargez un binaire pré-compilé depuis les <a href="https://github.com/FerrLabs/FerrFlow/releases/latest">Releases</a> :</p>
+<pre><code class="language-bash"># Linux x86_64
+curl -L https://github.com/FerrLabs/FerrFlow/releases/latest/download/ferrflow-linux-x64.tar.gz | tar xz
+sudo mv ferrflow /usr/local/bin/
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="Docker"><p class="ferr-tab__label">Docker</p><div class="ferr-tab__body"><pre><code class="language-bash">docker run --rm -v $(pwd):/repo ghcr.io/ferrlabs/ferrflow:latest check
+</code></pre>
+</div></div>
+</div>
+
+## Installation CI
+
+La méthode recommandée pour utiliser FerrFlow en CI est la GitHub Action — aucune étape d'installation nécessaire :
+
+```yaml
+- uses: FerrLabs/ferrflow@v5
+  env:
+    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+Consultez [GitHub Actions](/fr/docs/ci/github-actions) et [GitLab CI](/fr/docs/ci/gitlab-ci) pour des exemples complets.
+
+## Vérification
+
+```bash
+ferrflow --version
+```
+
+## Migration depuis la v4
+
+Si vous suivez la configuration documentée pour GitHub Actions / GitLab CI (`GITHUB_TOKEN` / `CI_JOB_TOKEN` en variable d'environnement), aucun changement n'est nécessaire — il suffit de bumper le pin de l'action à `FerrLabs/ferrflow@v5` et le binaire à la v5.x.
+
+Le seul changement cassant de la v5.0 est interne : FerrFlow n'injecte plus les tokens dans l'URL distante lors des push. Il utilise désormais le protocole standard de credential helper de git (`GIT_ASKPASS`). C'est invisible pour quiconque suit la configuration recommandée, mais si vous aviez un workflow custom qui s'appuyait sur des tokens injectés dans l'URL — par exemple, un runner self-hosted avec un remote pré-amorcé `https://x-access-token:$TOKEN@github.com/...` — passez à `GITHUB_TOKEN` (ou `FERRFLOW_TOKEN`) en variable d'environnement et FerrFlow se charge du reste.
+
+Depuis la v5.2, les releases sont signées via Sigstore et embarquent un SBOM CycloneDX — voir [Vérifier les releases](/fr/docs/verifying-releases).

package/docs-fr-v6/introduction.md

@@ -0,0 +1,54 @@
+---
+title: Introduction
+description: Ce qu'est FerrFlow et pourquoi il existe.
+---
+
+FerrFlow est un binaire unique qui automatise le versionnage sémantique pour n'importe quel repository — monorepo ou classique, quel que soit le langage.
+
+Il analyse votre historique de commits, détermine le bon incrément de version, met à jour vos fichiers de version, rédige un changelog, crée un tag git et publie une release. Zéro dépendance runtime.
+
+<div class="ferr-card-group" data-cols="2">
+  <div class="ferr-card"><p class="ferr-card__title">CLI d'abord</p><div class="ferr-card__body"><p>Tout se passe depuis votre terminal ou votre CI. Aucune UI à cliquer, aucun serveur de configuration à surveiller.</p>
+</div></div>
+  <div class="ferr-card"><p class="ferr-card__title">Multi-forge</p><div class="ferr-card__body"><p>GitHub, GitLab, auto-hébergé — FerrFlow s&#39;adapte à votre forge. Un seul outil, toutes les plateformes.</p>
+</div></div>
+  <div class="ferr-card"><p class="ferr-card__title">Commits conventionnels</p><div class="ferr-card__body"><p>Analyse l&#39;historique des commits pour déterminer les incréments de version automatiquement. Aucune maintenance manuelle du changelog.</p>
+</div></div>
+  <div class="ferr-card"><p class="ferr-card__title">Zéro infra</p><div class="ferr-card__body"><p>Un seul binaire, sans daemon, sans serveur, sans base de données. Tourne là où votre CI tourne.</p>
+</div></div>
+</div>
+
+## Pourquoi pas semantic-release ou changesets ?
+
+La plupart des outils de versionnage sont liés à un écosystème spécifique ou nécessitent Node.js dans votre CI.
+
+| Outil            | Monorepo    | Multi-langage      | Runtime   |
+| ---------------- | ----------- | ------------------ | --------- |
+| semantic-release | via plugins | JS/Node uniquement | Node.js   |
+| changesets       | bump manuel | JS uniquement      | Node.js   |
+| release-please   | limité      | partiel            | Node.js   |
+| cargo-release    | non         | Rust uniquement    | Rust      |
+| **FerrFlow**     | **natif**   | **tous**           | **aucun** |
+
+FerrFlow est distribué sous forme de binaire compilé. Déposez-le dans n'importe quel environnement CI sans installer de runtime. Un build WASM (`@ferrflow/wasm`) est également disponible pour une utilisation côté navigateur. Pour la comparaison côte-à-côte (latence, RSS, taille) avec les outils de release JS, voir [Performance](/fr/performance) — chiffres rafraîchis à chaque release.
+
+<aside class="ferr-aside ferr-aside--note"><p class="ferr-aside__title">À noter</p><div class="ferr-aside__body"><p>FerrFlow ne fait que du versionnage. Le suivi des issues, les secrets et les agents IA vivent dans d&#39;autres produits FerrLabs.</p>
+</div></aside>
+
+## Comment ça marche
+
+1. **Lit les commits** depuis le dernier tag git pour chaque package
+2. **Détermine l'incrément** à partir des [Conventional Commits](/fr/docs/reference/conventional-commits) (`feat` → minor, `fix` → patch, breaking → major)
+3. **Met à jour les fichiers de version** — `Cargo.toml`, `package.json`, `pom.xml`, etc.
+4. **Rédige le changelog** au format Keep a Changelog
+5. **Crée un tag git** (`api@v1.2.0`) et pousse
+6. **Publie une release GitHub/GitLab** avec le changelog comme notes de version
+
+Dans un monorepo, FerrFlow ne publie que les packages modifiés et comprend les chemins de dépendances partagées.
+
+## Fonctionnalités clés
+
+- **Hooks pre/post-release** — exécutez des scripts à chaque étape du cycle de vie (bump, commit, publish, failure)
+- **Commandes de requête** — `ferrflow version`, `ferrflow tag` et `ferrflow status` pour le scripting CI
+- **Tout fichier de version** — Cargo.toml, package.json, pom.xml, build.gradle, Chart.yaml, texte brut, et plus
+- **Support navigateur** — `@ferrflow/wasm` apporte le parsing de commits, le calcul de bump et la génération de changelog dans le navigateur