@ferrflow/doc 7.17.0

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

@@ -0,0 +1,128 @@
+---
+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
+```
+
+## 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 class="ferr-tab" data-label="YAML"><p class="ferr-tab__label">YAML</p><div class="ferr-tab__body"><pre><code class="language-yaml">package:
+  versionedFiles:
+    - path: Cargo.toml
+      format: toml
+    - path: npm/package.json
+      format: json
+</code></pre>
+</div></div>
+</div>
+
+Les deux fichiers seront mis à jour avec la même version avant le commit git.

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

@@ -0,0 +1,324 @@
+---
+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>
+
+## 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-v4/installation.md

@@ -0,0 +1,48 @@
+---
+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 ferrflow
+# ou en dépendance de développement
+npm install -D 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@v4
+  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
+```

package/docs-fr-v4/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

package/docs-fr-v4/legal/telemetry.md

@@ -0,0 +1,65 @@
+---
+title: Telemetrie
+description: Ce que FerrFlow collecte, comment les donnees sont anonymisees, et comment desactiver la telemetrie.
+---
+
+FerrFlow collecte des donnees de telemetrie anonymes pour ameliorer l'outil. Cette page explique exactement ce qui est envoye, comment les donnees sont anonymisees, et comment desactiver la telemetrie.
+
+## Ce qui est collecte
+
+A chaque execution d'une commande, FerrFlow peut envoyer un evenement contenant :
+
+| Champ           | Description                                                       |
+| --------------- | ----------------------------------------------------------------- |
+| `event_type`    | L'action effectuee : `check`, `release`, `version_bump` ou `init` |
+| `commits_count` | Nombre de commits depuis la derniere release                      |
+| `repo_hash`     | Un hash SHA-256 de l'URL du remote git (voir ci-dessous)          |
+
+Seuls les champs pertinents sont inclus. Les champs vides sont omis.
+
+## Comment les donnees sont anonymisees
+
+L'URL de votre depot n'est **jamais envoyee en clair**. FerrFlow calcule un hash SHA-256 de l'URL du remote git et envoie uniquement le digest hexadecimal. Cela permet de compter les depots uniques sans savoir lesquels ils sont.
+
+Aucun code source, nom de fichier, message de commit, nom de branche, nom de package, numero de version, adresse IP ou information personnelle n'est collecte ou stocke.
+
+## Ou les donnees sont envoyees
+
+Les evenements sont envoyes via une requete POST a `https://api.ferrflow.com/events`. La requete est asynchrone et non-bloquante — elle ne ralentit jamais votre workflow. Si la requete echoue, elle est silencieusement ignoree.
+
+## Comment desactiver
+
+Vous pouvez desactiver completement la telemetrie via une variable d'environnement ou votre fichier de configuration.
+
+### Variable d'environnement
+
+<div class="ferr-tabs">
+  <div class="ferr-tab" data-label="Linux / macOS"><p class="ferr-tab__label">Linux / macOS</p><div class="ferr-tab__body"><pre><code class="language-bash">export FERRFLOW_ANONYMOUS_TELEMETRY=false
+</code></pre>
+</div></div>
+  <div class="ferr-tab" data-label="Windows"><p class="ferr-tab__label">Windows</p><div class="ferr-tab__body"><pre><code class="language-powershell">$env:FERRFLOW_ANONYMOUS_TELEMETRY = &quot;false&quot;
+</code></pre>
+</div></div>
+</div>
+
+Valeurs acceptees pour desactiver : `false`, `0`, `off`, `no` (insensible a la casse).
+
+Depuis la v4.10, FerrFlow honore aussi la variable d'environnement standard [`DO_NOT_TRACK`](https://consoledonottrack.com/) — `DO_NOT_TRACK=1` desactive la telemetrie sans aucune configuration specifique. `FERRFLOW_TELEMETRY=false` reste pris en charge comme alternative pour la retrocompatibilite avec les configs v0/v1.
+
+### Fichier de configuration
+
+<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;anonymous_telemetry&quot;: false
+  }
+}
+</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]
+anonymous_telemetry = false
+</code></pre>
+</div></div>
+</div>
+
+L'une ou l'autre methode suffit pour desactiver la telemetrie.