@mcptoolshop/housekeeping 1.3.1 → 1.4.0

package/README.fr.md

@@ -10,7 +10,8 @@
 
 <p align="center">
   An operational-health warehouse for a GitHub organization.<br>
-  One sweep, one SQLite database, findings you can argue with.
+  One sweep, one SQLite database, findings you can argue with,<br>
+  and the whole-organization view an AI agent needs to coordinate every repository.
 </p>
 
 <p align="center">
@@ -20,39 +21,101 @@
   <a href="https://mcp-tool-shop-org.github.io/housekeeping/handbook/"><img src="https://img.shields.io/badge/Handbook-read-blue" alt="Handbook" /></a>
 </p>
 
-Une seule analyse collecte l’état du CI de chaque dépôt, les problèmes ouverts et les demandes de fusion, les versions, les étiquettes de version, les fichiers de flux de travail, la protection des branches, les alertes de sécurité, les fichiers de verrouillage et la facturation d’Actions dans SQLite, puis effectue un audit complet en fonction des règles définies.
+Une seule analyse collecte l’état des CI de chaque dépôt, les problèmes ouverts et les demandes de fusion, les versions, les étiquettes de version, les fichiers de flux de travail, la protection des branches, les alertes de sécurité, les fichiers de verrouillage et la facturation d’Actions dans SQLite, puis effectue un audit complet en fonction des règles définies.
 
-Il répond, pour l’ensemble de l’organisation :
+Il répond, pour l’ensemble de l’organisation, aux questions suivantes :
 
 - Quelles sont les branches par défaut qui présentent des problèmes, et s’agit-il d’une branche principale défectueuse ou d’un historique obsolète ?
-- Quelles demandes de fusion ne peuvent jamais être fusionnées, car une vérification requise qui ne renvoie aucune donnée les bloque-t-elle ?
-- Quels déploiements les paramètres propres au dépôt refusent-ils ?
+- Quelles sont les demandes de fusion qui ne pourront jamais être fusionnées, car une vérification requise qui ne renvoie aucune donnée les bloque-t-elle ?
+- Quels sont les déploiements que les paramètres du dépôt refusent ?
 - Où `package.json`, les étiquettes Git et le registre npm ont-ils divergé ?
-- Quels flux de travail enfreignent les règles de coût d’Actions, quel a été leur coût et quelles tâches ont consommé ces ressources ?
-- Quels dépôts contiennent des avis que le propre système d’alerte de GitHub ne détecte pas ?
+- Quels sont les flux de travail qui enfreignent les règles de coût d’Actions, quel a été leur coût et quelles tâches ont généré ces coûts ?
+- Quels sont les dépôts qui contiennent des avis que le propre système d’alerte de GitHub ne détecte pas ?
 
 Il s’agit d’un outil d’audit, et non d’un correcteur. Il lit les données de GitHub et ne modifie rien.
 
-## Pourquoi il a cette structure
+## Un agent pour chaque dépôt
+
+Une organisation comptant des dizaines de dépôts n’a pas d’emplacement unique où sont stockées ses données. housekeeping est cet emplacement, et son serveur MCP, `hk-mcp`, transmet ces données à un agent d’IA. Grâce à cela, un seul agent peut agir comme coordinateur pour l’ensemble de l’organisation :
+
+1. **Analyse.** `hk refresh` effectue une analyse de chaque dépôt.
+2. **Tri.** L’agent demande quelles sont les données problématiques, ce qui est bloqué et ce qui s’est aggravé, et obtient des réponses qui permettent déjà de distinguer une branche principale défectueuse d’un historique obsolète, et une demande de fusion bloquée d’une demande en conflit.
+3. **Planification d’une vague.** Une seule requête `hk_sql` trouve tous les dépôts qui présentent la même configuration, de sorte qu’une correction devient une seule demande de fusion par dépôt au lieu d’une recherche fastidieuse.
+4. **Réalisation des tâches.** housekeeping n’écrit jamais. L’agent ouvre des demandes de fusion avec ses propres outils, en utilisant ses propres autorisations et sous votre contrôle.
+5. **Vérification.** Nouvelle analyse. Soit le problème est résolu, soit il ne l’est pas, et la différence entre deux analyses est une requête.
+
+Questions auxquelles un agent répond en une ou deux étapes :
+
+- Quelles sont les branches par défaut qui présentent des problèmes, et quelle tâche et quelle étape sont à l’origine du problème ?
+- Quelles sont les demandes de fusion qui ne pourront jamais être fusionnées, et est-ce le déclencheur ou un conflit qui en est la cause ?
+- Quels sont les dépôts qui contiennent un avis de production pour lequel GitHub n’affiche aucune alerte ?
+- Quels sont les flux de travail planifiés qui enfreignent les règles relatives aux plannings, et comment ?
+- Quel a été le coût d’Actions, et quelle tâche a généré ces coûts ?
+- Qu’est-ce qui a changé depuis la dernière analyse ?
+
+| Outil | Ce à quoi il répond |
+|---|---|
+| `hk_summary` | Totaux pour la dernière analyse : dépôts, problèmes, demandes de fusion, flux de travail, résultats. |
+| `hk_findings` | Résultats par code, gravité, catégorie ou dépôt ; nombre par code lorsque les résultats ne sont pas filtrés. Le résultat d’une branche principale problématique indique la tâche et l’étape qui ont causé le problème. |
+| `hk_ci` | Dépôts dont la branche par défaut présente des problèmes et flux de travail qui ont échoué ; également, plannings ayant échoué, branches de demandes de fusion ayant échoué et dépôts sans CI. |
+| `hk_repo` | Un dépôt en détail : résultats, flux de travail, demandes de fusion et problèmes ouverts. |
+| `hk_backlog` | Demandes de fusion ou problèmes ouverts dans l’ensemble de l’organisation, du plus ancien au plus récent. |
+| `hk_health` | Un score de santé par dépôt, du moins bon au meilleur. |
+| `hk_cost` | Dépenses d’Actions par dépôt, flux de travail ou tâche, brutes et nettes. |
+| `hk_sql` | Une seule instruction `SELECT` ou `WITH` en lecture seule par rapport à l’entrepôt de données. |
+| `hk_schema` | Les tables et les colonnes, pour écrire des requêtes `hk_sql`. |
+
+Toute réponse provient de la dernière analyse, ouverte en lecture seule. Une requête ayant échoué renvoie une erreur structurée, et non une trace de pile.
+
+### Connectez-le
+
+```json
+{
+  "mcpServers": {
+    "housekeeping": { "command": "hk-mcp", "env": { "HK_HOME": "/path/to/warehouse" } },
+    "atlas": { "command": "atlas", "args": ["mcp"] }
+  }
+}
+```
+
+`HK_HOME` est le répertoire à partir duquel vous effectuez l’analyse. À partir d’un clone, utilisez `"command": "node", "args": ["/path/to/housekeeping/src/mcp.mjs"]`. Le deuxième serveur est [Atlas](https://github.com/dogfood-lab/testing-os/tree/main/packages/atlas), qui répond aux mêmes questions concernant un seul dépôt à la fois (voir ci-dessous). Sous Windows, démarrez une commande installée globalement via `cmd /c`.
+
+## housekeeping et Atlas
+
+[Atlas](https://github.com/dogfood-lab/testing-os/tree/main/packages/atlas) (`@dogfood-lab/atlas`) mappe un dépôt : ses composants et ses portes, ce qui signifie chaque flux de travail avec ce qu’il exécute, publie et déploie. La carte est validée en tant que `atlas/` et vérifiée dans CI. housekeeping est la vue de l’organisation. Les deux sont conçus pour fonctionner ensemble.
+
+- **Chaque carte, analysée.** Une analyse lit la carte validée de chaque dépôt ainsi que tous les autres éléments, et signale quels sont les dépôts qui n’en ont pas, lesquels n’exécutent jamais `atlas check` et lesquels contiennent un moteur différent de celui que le reste de l’organisation utilise.
+- **Où une exécution problématique a échoué.** Lorsqu’une branche par défaut présente des problèmes, le résultat indique la tâche et l’étape qui ont échoué et, grâce à la carte, la commande que cette étape exécute, de sorte que la correction commence dans le bon fichier.
+- **Informations sur le déploiement à partir de la carte.** L’environnement vers lequel une tâche se déploie est extrait de la carte où il est enregistré, de sorte que les deux outils lisent un flux de travail de la même manière.
+- **Avertissements dans l’ensemble du parc.** Atlas signale une étape de flux de travail qui échouera avant son exécution, comme un outil qui nécessite une version d’exécution plus récente que celle installée par la tâche. Le rapport répertorie ces éléments pour tous les dépôts à la fois.
+
+Un agent utilisant les deux serveurs passe de « ces douze dépôts sont bloqués » (housekeeping) à « il s’agit du flux de travail, de la tâche et des fichiers qu’une modification affectera » (Atlas), sans avoir à ouvrir chaque dépôt manuellement.
+
+## Pourquoi il est structuré de cette manière
 
 | Couche | Choix | Raison |
 |---|---|---|
-| Transport | l’interface de ligne de commande `gh` | Il contient déjà votre jeton. L’outil ne stocke ni ne demande jamais d’informations d’identification. |
-| Collecte | GitHub GraphQL, avec pagination | Une seule requête renvoie les métadonnées, les problèmes ouverts, les demandes de fusion ouvertes, les versions et les arborescences de fichiers pour une page de dépôts. Une page dont le délai d’attente est constamment dépassé est divisée par deux et la requête est renvoyée à partir du même curseur. |
-| Exécutions d’Actions | REST | GraphQL ne dispose pas d’interface Actions. |
-| Coût d’Actions | API de facturation plus durées par tâche | La facture indique de quel dépôt il s’agit ; seules les tâches indiquent de quel flux de travail il s’agit. Les points de terminaison `/timing` de GitHub renvoient des zéros, de sorte que la somme par tâche est reconstruite, puis rapprochée de la facture. |
-| Tarifs des exécuteurs | lu dans la facture | Un tarif facturé peut différer du prix catalogue, et une constante dans la source fausserait tous les chiffres. |
-| Stockage | SQLite via l’outil `node:sqlite` intégré | Aucune étape de compilation native. |
-| Source de vérité | `data/snapshots/*.json` | Brut, diffusable et en ajout uniquement. La base de données est dérivée : `npm run rebuild` la reconstruit hors ligne. |
-| Journal d’analyse | `data/sweeps.jsonl` | Une ligne par analyse, y compris les analyses ayant échoué et les analyses n’ayant rien trouvé de nouveau. |
+| Transport | L’interface de ligne de commande `gh` | Elle contient déjà votre jeton. L’outil ne stocke ni ne demande jamais d’informations d’identification. |
+| Collecte | GitHub GraphQL, paginée | Une requête renvoie les métadonnées, les problèmes ouverts, les demandes de fusion ouvertes, les versions et les arborescences de fichiers pour une page de dépôts. Une page qui continue de dépasser le délai d’attente est divisée par deux et la requête est renvoyée à partir du même curseur. |
+| Exécutions d’Actions | REST | GraphQL ne dispose pas d’une interface Actions. |
+| Les actions ont un coût. | API de facturation plus durée par tâche. | La facture indique de quel dépôt il s’agit ; seules les tâches indiquent de quel flux de travail il s’agit. Les points de terminaison `/timing` de GitHub renvoient des zéros, de sorte que la somme par tâche est reconstruite, puis rapprochée de la facture. |
+| Tarifs des exécuteurs. | Lus dans la facture. | Un tarif facturé peut différer du prix catalogue, et une constante dans la source fausserait tous les chiffres. |
+| Stockage. | SQLite via le `node:sqlite` intégré. | Aucune étape de compilation native. |
+| Source de vérité. | `data/snapshots/*.json` | Brut, diffusable et en ajout uniquement. La base de données est dérivée : `npm run rebuild` la reconstruit hors ligne. |
+| Journal de balayage. | `data/sweeps.jsonl` | Une ligne par balayage, y compris les balayages ayant échoué et les balayages n’ayant rien trouvé de nouveau. |
 
 Les instantanés sont immuables et additifs, de sorte que la dérive entre deux dates est un `JOIN`.
 
 ## Exigences
 
 - Node.js 22.5 ou version ultérieure.
-- L’[interface de ligne de commande GitHub](https://cli.github.com/), connectée (`gh auth status`) avec un compte qui peut lire l’organisation. La lecture de la facturation et des alertes de sécurité nécessite les autorisations correspondantes ; une analyse sans ces autorisations enregistre « non mesuré » et continue. Elle n’enregistre jamais une autorisation manquante comme un résultat valide.
-- Windows ou Linux. Il est développé sur Windows et ses tests sont exécutés sur Linux dans le cadre de l’intégration continue. macOS devrait fonctionner et n’est pas testé.
+- [GitHub CLI](https://cli.github.com/), connecté en tant que compte
+pouvant lire l’organisation (`gh auth status`). La lecture des informations de facturation
+et des alertes de sécurité nécessite les autorisations correspondantes ; un
+balayage sans celles-ci enregistre « non mesuré » et continue. Il n’enregistre
+jamais une autorisation manquante comme un résultat valide.
+- Windows ou Linux. Il est développé sous Windows et ses tests sont exécutés
+sous Linux en CI. macOS devrait fonctionner et n’est pas testé.
 
 ## Utilisation
 
@@ -62,7 +125,8 @@ mkdir warehouse && cd warehouse            # housekeeping keeps its data here
 hk refresh your-org                        # collect, load, analyze, write reports/AUDIT-<date>.md
 ```
 
-Pour conserver les paramètres entre les analyses, placez un fichier `housekeeping.config.json` dans ce répertoire (voir Configuration) ; ensuite, `hk refresh` n’aura besoin d’aucun argument.
+Pour conserver les paramètres entre les balayages, placez un `housekeeping.config.json` dans ce
+répertoire (voir Configuration) ; ensuite, `hk refresh` n’a besoin d’aucun argument.
 
 Ou exécutez-le à partir d’une copie, ce qui conserve ses données dans la copie :
 
@@ -75,7 +139,7 @@ cp housekeeping.config.example.json housekeeping.config.json   # then set "org"
 hk refresh
 ```
 
-Ensuite, interrogez-la :
+Ensuite, interrogez-le :
 
 ```bash
 hk summary               # portfolio totals
@@ -91,17 +155,23 @@ hk sql "SELECT ..."      # one read-only statement
 hk help                  # every command and flag
 ```
 
-Dans une copie sans fichier `npm link`, chaque exécution de `hk <command>` est `node src/cli.mjs <command>`.
+Dans une copie sans `npm link`, chaque `hk <command>` est `node src/cli.mjs <command>`.
 
-`npm run rebuild` redérive la base de données et le rapport à partir des instantanés déjà présents sur le disque, sans accès au réseau.
+`npm run rebuild` redérive la base de données et le rapport à partir des instantanés déjà
+présents sur le disque, sans accès au réseau.
 
-Une analyse complète effectue quelques centaines d’appels d’API. N’exécutez pas `refresh` en boucle.
+Un balayage complet effectue quelques centaines d’appels d’API. N’exécutez pas
+`refresh` en boucle.
 
-Les résultats sont envoyés vers la sortie standard ; les progrès et les erreurs sont envoyés vers la sortie d’erreur standard. Chaque erreur affiche un code et un indice. Codes de sortie : 0 (ok), 1 (erreur utilisateur), 2 (erreur d’exécution), 3 (partiel, l’analyse est terminée, mais avec des lacunes).
+Les résultats sont envoyés vers la sortie standard ; les progrès et les erreurs
+sont envoyés vers la sortie d’erreur standard. Chaque erreur affiche un code
+et un indice. Codes de sortie : 0 (ok), 1 (erreur utilisateur), 2 (erreur
+d’exécution), 3 (partiel, le balayage s’est terminé, avec des lacunes).
 
 ## Configuration
 
-`housekeeping.config.json`, dans le répertoire dans lequel l’outil de maintenance fonctionne (voir ci-dessous) :
+`housekeeping.config.json`, dans le répertoire dans lequel l’outil de maintenance fonctionne (voir
+ci-dessous) :
 
 ```json
 {
@@ -110,60 +180,70 @@ Les résultats sont envoyés vers la sortie standard ; les progrès et les erre
 }
 ```
 
-- `org` est l’organisation à analyser. `hk refresh <org>` le remplace. En l’absence des deux, une analyse refuse de démarrer.
-- `metaRepos` sont les dépôts qui contiennent les paramètres, les ressources ou les outils de l’organisation, et non un produit commercialisé. Ils sont exemptés des résultats qui ne sont pertinents que pour un produit : absence de fichiers README, LICENSE et similaires, absence de flux de travail et absence de versions.
-
-Un fichier malformé est une erreur, et non une valeur par défaut silencieuse : une clé inconnue, un type incorrect ou un JSON corrompu interrompent l’exécution.
-
-Exécution à partir d’un clone, l’outil de maintenance conserve `data/`, `reports/` et le fichier de configuration dans le clone. Exécution en tant que package installé, il les conserve dans le répertoire à partir duquel vous l’exécutez, ou dans `HK_HOME` si celui-ci est défini.
-
-Environnement : `HK_HOME` (où les données, les rapports et la configuration sont stockés), `HK_CONFIG` (chemin du fichier de configuration), `HK_DB` (chemin de la base de données), `HK_LOG` (`silent`, `normal`, `verbose` ou `debug`), `HK_COST_REPOS` et `HK_COST_BUDGET` (limites du coût par tâche), `GH_PATH` (chemin vers `gh`).
-
-## Gardez les données privées
+- `org` est l’organisation à analyser. `hk refresh <org>` le remplace. En l’absence des
+deux, un balayage refuse de démarrer.
+- `metaRepos` sont les dépôts qui contiennent les paramètres par défaut, les
+ressources ou les outils de l’organisation, et non un produit commercialisé.
+Ils sont exemptés des résultats qui n’ont de sens que pour un produit :
+absence de fichiers README, LICENSE et similaires, absence de flux de travail
+et absence de versions.
 
-**Ce qu’une analyse écrit est sensible. Ne committez pas `data/` ou `reports/` dans un dépôt public.**
+Un fichier malformé est une erreur, jamais une valeur par défaut silencieuse :
+une clé inconnue, un type incorrect ou un JSON corrompu interrompent l’exécution.
 
-Un instantané enregistre les noms et les descriptions des dépôts privés, chaque alerte de sécurité ouverte avec le package qu’elle mentionne, les fichiers de flux de travail et la facturation d’Actions. GitHub masque délibérément les alertes de sécurité d’un dépôt public à tous, sauf à ses responsables ; un instantané publié diffuserait cette liste.
+Exécution à partir d’une copie, l’outil de maintenance conserve `data/`, `reports/` et le
+fichier de configuration dans la copie. Exécution en tant que package installé,
+il les conserve dans le répertoire à partir duquel vous l’exécutez, ou dans
+`HK_HOME` lorsque cela est défini.
 
-Le `.gitignore` de ce dépôt exclut `data/`, `reports/` et `housekeeping.config.json`. Pour conserver l’historique, ce qui est l’objectif des instantanés, exécutez l’outil à partir d’un **dépôt privé** et committez-les dans celui-ci.
+Environnement : `HK_HOME` (où les données, les rapports et la configuration sont
+stockés), `HK_CONFIG` (chemin de configuration), `HK_DB` (chemin de la base de données),
+`HK_LOG` (`silent`, `normal`, `verbose` ou `debug`), `HK_COST_REPOS` et `HK_COST_BUDGET` (limites du coût par tâche), `GH_PATH`
+(chemin vers `gh`).
 
-## Serveur MCP
+## Conserver les données en privé
 
-Le fichier `hk-mcp` (ou `npm run mcp` dans une copie) sert de référentiel via stdio, ce qui permet à un assistant de poser des questions sans avoir à lire un instantané de plusieurs mégaoctets :
-
-`hk_summary` · `hk_findings` · `hk_ci` · `hk_repo` · `hk_backlog` · `hk_health` · `hk_cost` · `hk_sql` · `hk_schema`
-
-```json
-{
-  "mcpServers": {
-    "housekeeping": { "command": "hk-mcp", "env": { "HK_HOME": "/path/to/warehouse" } }
-  }
-}
-```
+**Ce qu’un balayage écrit est sensible. Ne committez pas `data/` ou `reports/` dans un
+dépôt public.**
 
-`HK_HOME` est le répertoire à partir duquel vous effectuez l’analyse. À partir d’une copie, utilisez `"command": "node", "args": ["/path/to/housekeeping/src/mcp.mjs"]` à la place.
+Un instantané enregistre les noms et les descriptions des dépôts privés, toutes
+les alertes de sécurité ouvertes avec le package qu’il nomme, les fichiers de
+flux de travail et la facturation d’Actions. GitHub masque délibérément les
+alertes de sécurité d’un dépôt public à tous, sauf à ses mainteneurs ; un
+instantané publié diffuserait cette liste.
 
-`hk_sql` accepte une seule instruction `SELECT` ou `WITH` et ouvre la base de données en lecture seule. Un appel ayant échoué renvoie une erreur structurée, et non une trace de pile.
+Le `.gitignore` de ce dépôt exclut `data/`, `reports/` et `housekeeping.config.json`. Pour conserver l’historique, ce qui
+est l’objectif des instantanés, exécutez l’outil à partir d’un **dépôt privé**
+qui vous appartient et committez-les là.
 
 ## Résultats
 
-Les règles sont stockées dans `src/analyze.mjs`. Chacune d’entre elles fait référence à la règle écrite qu’elle applique, de sorte qu’un résultat peut être contesté par rapport à une norme et non par rapport au goût. Les règles fournies avec ce dépôt sont disponibles dans [`rules/`](rules/) :
+Les règles sont stockées dans `src/analyze.mjs`. Chacune d’entre elles cite la règle écrite
+qu’elle applique, de sorte qu’un résultat peut être contesté par rapport à une
+norme et non par rapport au goût. Les règles que ce dépôt contient sont
+disponibles dans [`rules/`](rules/) :
 
-- [`rules/github-actions.md`](rules/github-actions.md) : filtres de chemins, exécuteurs, taille de la matrice, limite du fichier de flux de travail, concurrence.
-- [`rules/shipcheck-product-standards.md`](rules/shipcheck-product-standards.md) : l’intégration continue doit réussir, les étapes de validation, les versions.
+- [`rules/github-actions.md`](rules/github-actions.md) : filtres de chemins, exécuteurs, taille de
+la matrice, limite du fichier de flux de travail, concurrence.
+- [`rules/shipcheck-product-standards.md`](rules/shipcheck-product-standards.md) : la CI doit réussir, les
+portes de publication, les versions.
 - [`rules/repo-first.md`](rules/repo-first.md) : la branche par défaut.
-- [`rules/atlas-map.md`](rules/atlas-map.md) : une carte validée de chaque dépôt, vérifiée dans l’intégration continue.
+- [`rules/atlas-map.md`](rules/atlas-map.md) : une carte validée de chaque dépôt, vérifiée en
+CI.
 
-Ce sont les normes d’une organisation. Si les vôtres sont différentes, modifiez le fichier de règle et la règle elle-même.
+Ce sont les normes d’une organisation. Si les vôtres sont différentes,
+modifiez le fichier de règle et la règle en même temps.
 
-Les règles veillent à séparer les éléments qui se ressemblent, car les regrouper crée du bruit :
+Les règles veillent à distinguer les éléments qui se ressemblent, car leur
+regroupement produit du bruit.
 
-- **Une branche par défaut rouge n’est pas une branche de demande de fusion rouge.** Une branche Dependabot qui échoue est un élément en attente ; une exécution `push` qui échoue sur la branche par défaut est une erreur. L’événement de l’exécution détermine lequel.
-- **L’historique n’est pas une erreur.** Un flux de travail déplacé vers des déclencheurs de publication uniquement conserve son dernier échec de branche par défaut pour toujours. Un flux de travail supprimé conserve ses exécutions. Aucun n’est un défaut actif.
-- **Une vérification requise qui ne peut rien produire n’est pas une vérification qui n’a pas été exécutée ici.** L’une indique qu’il faut supprimer l’exigence ; l’autre indique qu’il faut corriger le déclencheur. Les corrections se contredisent.
-- **Une exécution ayant échoué n’est pas une exécution annulée.** `cancel-in-progress` sert à arrêter les exécutions obsolètes, de sorte que les minutes annulées correspondent généralement au fonctionnement de la règle de concurrence.
+- **Une branche par défaut rouge n’est pas une branche de requête d’extraction rouge.** Une branche Dependabot qui échoue est une tâche en attente ; une exécution `push` qui échoue sur la branche par défaut est une erreur. L’événement de l’exécution détermine laquelle.
+- **L’historique n’est pas une erreur.** Un flux de travail déplacé vers un déclencheur de publication uniquement conserve son dernier échec de branche par défaut pour toujours. Un flux de travail supprimé conserve ses exécutions. Aucun des deux n’est un défaut actif.
+- **Une vérification obligatoire qui ne peut rien produire n’est pas une vérification qui n’a pas été exécutée ici.** L’une dit de supprimer l’exigence ; l’autre dit de corriger le déclencheur. Les corrections se contredisent.
+- **Une requête d’extraction que le déclencheur a ignorée n’est pas une requête en conflit.** GitHub n’exécute aucun flux de travail de requête d’extraction sur une requête d’extraction contenant des conflits, de sorte que sa vérification manquante n’indique rien sur le déclencheur. Celle-ci nécessite une réinitialisation.
+- **Une exécution ayant échoué n’est pas une exécution annulée.** `cancel-in-progress` sert à interrompre les exécutions obsolètes, de sorte que les minutes annulées correspondent généralement au fonctionnement de la règle de concurrence.
 - **Le coût brut n’est pas le coût net.** GitHub facture les dépôts publics au prix fort et les réduit à zéro. Le coût brut est la puissance de calcul réelle ; le coût net est l’argent réel. Ils ne sont jamais additionnés.
-- **Ce qui n’est pas mesuré n’est pas propre.** Un dépôt GitHub qui n’effectue pas d’analyse signale zéro alerte. Un dépôt pour lequel le seuil de coût n’a pas été atteint n’a pas de ligne de coût. Les deux sont signalés comme inconnus.
+- **Ce qui n’est pas mesuré n’est pas propre.** Un dépôt que GitHub n’analyse pas signale zéro alerte. Un dépôt pour lequel le processus de calcul des coûts n’a pas abouti n’a pas de ligne de coûts. Les deux sont signalés comme inconnus.
 
 La gravité détermine un score de santé : critique 40, élevé 15, moyen 6, faible 2, information 0, déduit de 100. Le score classe l’attention, et non la qualité.
 
@@ -171,9 +251,9 @@ Le [manuel](https://mcp-tool-shop-org.github.io/housekeeping/handbook/) réperto
 
 ## Sécurité
 
-- **Lecture seule.** Le collecteur effectue des requêtes GraphQL et des requêtes REST `GET`. Il ne fusionne, ne pousse, ne publie, ne distribue ni ne modifie jamais un paramètre.
+- **Lecture seule.** Le collecteur effectue des requêtes GraphQL et des requêtes REST `GET`. Il ne fusionne, ne pousse, ne publie, ne modifie jamais un paramètre.
 - **Aucun identifiant.** L’authentification est ce que `gh` contient déjà. Rien n’est écrit sur le disque à ce sujet.
-- **Aucune télémétrie.** Les seuls hôtes contactés sont l’API GitHub, via `gh`, et le registre npm, pour les recherches de versions et de conseils.
+- **Aucune télémétrie.** Les seuls hôtes contactés sont l’API GitHub, via `gh`, et le registre npm, pour les recherches de version et de conseils.
 - **Ce qu’il stocke** est la partie sensible : voir « Conserver les données en privé ».
 
 Signalez une vulnérabilité comme décrit dans [SECURITY.md](SECURITY.md).