@mcptoolshop/claude-guardian 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1] - 2026-02-27
+
+### Added
+- CI workflow with build, test, and code coverage
+- Codecov badge and coverage upload
+- npm version badge in README
+- Quality scorecard in README and landing page (49/50)
+
+### Changed
+- Landing page footer standardized to MCP Tool Shop link
+- Landing page npm URL corrected to scoped package name
+- Updated translations (7 languages)
+
 ## [1.1.0] - 2026-02-27
 
 ### Added

package/README.es.md

@@ -2,19 +2,21 @@
   <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.md">English</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
 </p>
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-guardian/readme.png" width="400" alt="claude-guardian" />
-</p>
-
-<p align="center">
-  <a href="https://github.com/mcp-tool-shop-org/claude-guardian/actions"><img src="https://github.com/mcp-tool-shop-org/claude-guardian/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
-  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License" /></a>
-  <a href="https://mcp-tool-shop-org.github.io/claude-guardian/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page" /></a>
-</p>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-guardian/readme.png" width="400" alt="claude-guardian" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/claude-guardian/actions"><img src="https://github.com/mcp-tool-shop-org/claude-guardian/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/claude-guardian"><img src="https://img.shields.io/npm/v/@mcptoolshop/claude-guardian" alt="npm" /></a>
+  <a href="https://codecov.io/gh/mcp-tool-shop-org/claude-guardian"><img src="https://img.shields.io/codecov/c/github/mcp-tool-shop-org/claude-guardian" alt="Coverage" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License" /></a>
+  <a href="https://mcp-tool-shop-org.github.io/claude-guardian/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page" /></a>
+</p>
 
 Computadora de vuelo para Claude Code: rotación de registros, supervisión, paquetes de fallos y autoconciencia del MCP.
 
-Claude Guardian es una capa de confiabilidad local que mantiene las sesiones de Claude Code en buen estado. Detecta el crecimiento excesivo de los registros, la presión en el disco y las interrupciones antes de que causen problemas, captura evidencia cuando algo sale mal y expone un servidor MCP para que Claude pueda realizar un automonitoreo durante la sesión.
+Claude Guardian es una capa de confiabilidad local que mantiene las sesiones de Claude Code en buen estado. Detecta problemas de espacio en disco, sobrecarga y bloqueos antes de que causen problemas, captura evidencia cuando algo sale mal y expone un servidor MCP para que Claude pueda automonitorearse durante la sesión.
 
 ## ¿Qué hace?
 
@@ -22,74 +24,74 @@ Claude Guardian es una capa de confiabilidad local que mantiene las sesiones de
 |---------|---------|
 | `preflight` | Escanea los registros del proyecto Claude, informa sobre directorios/archivos de gran tamaño, opcionalmente corrige automáticamente. |
 | `doctor` | Genera un paquete de diagnóstico (zip) con información del sistema, fragmentos de registros y un registro. |
-| `run -- <cmd>` | Ejecuta cualquier comando con supervisión, crea automáticamente un paquete en caso de fallo/interrupción. |
-| `status` | Comprobación de estado: espacio libre en disco, tamaños de los registros, advertencias. |
-| `watch` | Demonio en segundo plano: monitoreo continuo, seguimiento de incidentes, cumplimiento del presupuesto. |
-| `budget` | Visualiza y gestiona el presupuesto de concurrencia (mostrar/obtener/liberar). |
+| `run -- <cmd>` | Ejecuta cualquier comando con supervisión, crea automáticamente un paquete en caso de fallo/bloqueo. |
+| `status` | Comprobación de estado rápida: espacio libre en disco, tamaños de los registros, advertencias. |
+| `watch` | Demonio en segundo plano: supervisión continua, seguimiento de incidentes, cumplimiento del presupuesto. |
+| `budget` | Visualiza y gestiona el presupuesto de concurrencia (mostrar/adquirir/liberar). |
 | `mcp` | Inicia el servidor MCP (8 herramientas) para el automonitoreo de Claude Code. |
 
 ## Instalación
 
-```bash
-npm install -g claude-guardian
-```
+```bash
+npm install -g claude-guardian
+```
 
 O ejecútelo directamente:
 
-```bash
-npx claude-guardian preflight
-```
+```bash
+npx claude-guardian preflight
+```
 
 ## Comienzo rápido
 
 ### Verifique su entorno
 
-```bash
-claude-guardian status
-```
-
-```
-=== Claude Guardian Preflight ===
-
-Disk free: 607.13GB [OK]
-Claude projects: C:\Users\you\.claude\projects
-Total size: 1057.14MB
-
-Project directories (by size):
-  my-project: 1020.41MB
-
-Issues found:
-  [WARNING] Project log dir is 1020.41MB (limit: 200MB)
-  [WARNING] File is 33.85MB (limit: 25MB)
-
-[guardian] disk=607.13GB | logs=1057.14MB | issues=2
-```
-
-### Corrige automáticamente el crecimiento excesivo de los registros
-
-```bash
-claude-guardian preflight --fix
-```
-
-Rota los registros antiguos (gzip), recorta los archivos `.jsonl` y `.log` de gran tamaño a sus últimas N líneas. Cada acción se registra en un archivo de registro para facilitar el seguimiento.
+```bash
+claude-guardian status
+```
+
+```
+=== Claude Guardian Preflight ===
+
+Disk free: 607.13GB [OK]
+Claude projects: C:\Users\you\.claude\projects
+Total size: 1057.14MB
+
+Project directories (by size):
+  my-project: 1020.41MB
+
+Issues found:
+  [WARNING] Project log dir is 1020.41MB (limit: 200MB)
+  [WARNING] File is 33.85MB (limit: 25MB)
+
+[guardian] disk=607.13GB | logs=1057.14MB | issues=2
+```
+
+### Corrige automáticamente los problemas de espacio en disco
+
+```bash
+claude-guardian preflight --fix
+```
+
+Rota los registros antiguos (gzip), reduce el tamaño de los archivos `.jsonl` y `.log` grandes a sus últimas N líneas. Cada acción se registra en un archivo de registro para facilitar el seguimiento.
 
 ### Genera un informe de fallo
 
-```bash
-claude-guardian doctor --out ./bundle.zip
-```
+```bash
+claude-guardian doctor --out ./bundle.zip
+```
 
 Crea un archivo zip que contiene:
-- `summary.json` — información del sistema, informe de tamaño de archivo, resultados de la verificación inicial.
-- `log-tails/` — las últimas 500 líneas de cada archivo de registro.
-- `journal.jsonl` — cada acción que ha realizado el guardián.
+- `summary.json`: información del sistema, informe de tamaño de archivo, resultados de la verificación inicial.
+- `log-tails/`: las últimas 500 líneas de cada archivo de registro.
+- `journal.jsonl`: cada acción que ha realizado el guardián.
 
 ### Ejecute con supervisión
 
-```bash
-claude-guardian run -- claude
-claude-guardian run --auto-restart --hang-timeout 120 -- node server.js
-```
+```bash
+claude-guardian run -- claude
+claude-guardian run --auto-restart --hang-timeout 120 -- node server.js
+```
 
 El sistema de supervisión:
 1. Ejecuta su comando como un proceso secundario.
@@ -99,32 +101,32 @@ El sistema de supervisión:
 
 ## Servidor MCP (la verdadera clave)
 
-Registre el guardián como un servidor MCP local para que Claude pueda realizar un automonitoreo:
+Registre el guardián como un servidor MCP local para que Claude pueda automonitorearse:
 
 Agregue lo siguiente a `~/.claude.json`:
 
-```json
-{
-  "mcpServers": {
-    "guardian": {
-      "command": "npx",
-      "args": ["claude-guardian", "mcp"]
-    }
-  }
-}
-```
+```json
+{
+  "mcpServers": {
+    "guardian": {
+      "command": "npx",
+      "args": ["claude-guardian", "mcp"]
+    }
+  }
+}
+```
 
 Luego, Claude puede llamar a:
 
 | Herramienta | Lo que devuelve |
 |------|----------------|
-| `guardian_status` | Disco, registros, procesos, riesgo de interrupción, presupuesto, nivel de atención. |
-| `guardian_preflight_fix` | Ejecuta la rotación/recorte de registros y devuelve un informe de antes y después. |
+| `guardian_status` | Espacio en disco, registros, procesos, riesgo de bloqueo, presupuesto, nivel de atención. |
+| `guardian_preflight_fix` | Ejecuta la rotación/reducción de tamaño de los registros y devuelve un informe de antes y después. |
 | `guardian_doctor` | Crea un paquete de diagnóstico (zip) y devuelve la ruta y un resumen. |
-| `guardian_nudge` | Corrección automática segura: corrige los registros si están hinchados, captura un paquete si es necesario. |
-| `guardian_budget_get` | Límite de concurrencia actual, espacios utilizados, concesiones activas. |
-| `guardian_budget_acquire` | Solicita espacios de concurrencia (devuelve el ID de la concesión). |
-| `guardian_budget_release` | Libera una concesión cuando hayas terminado con el trabajo intensivo. |
+| `guardian_nudge` | Corrección automática segura: corrige los registros si están sobrecargados y captura un paquete si es necesario. |
+| `guardian_budget_get` | Límite de concurrencia actual, espacios utilizados, licencias activas. |
+| `guardian_budget_acquire` | Solicita espacios de concurrencia (devuelve el ID de la licencia). |
+| `guardian_budget_release` | Libera una licencia cuando hayas terminado con tareas pesadas. |
 | `guardian_recovery_plan` | Plan de recuperación paso a paso que indica las herramientas exactas a utilizar. |
 
 Esto permite que Claude diga: "La atención es de NIVEL DE ADVERTENCIA. Ejecutando `guardian_nudge`, luego reduciendo la concurrencia".
@@ -133,11 +135,11 @@ Esto permite que Claude diga: "La atención es de NIVEL DE ADVERTENCIA. Ejecutan
 
 Tres opciones de configuración (todo lo demás está codificado con valores predeterminados razonables):
 
-| Bandera | Valor predeterminado | Descripción |
+| Opción | Valor predeterminado | Descripción |
 |------|---------|-------------|
 | `--max-log-mb` | `200` | Tamaño máximo del directorio de registros del proyecto en MB. |
-| `--hang-timeout` | `300` | Segundos de inactividad antes de declarar una interrupción. |
-| `--auto-restart` | `false` | Reiniciar automáticamente en caso de fallo/interrupción. |
+| `--hang-timeout` | `300` | Segundos de inactividad antes de declarar un bloqueo. |
+| `--auto-restart` | `false` | Reiniciar automáticamente en caso de fallo/bloqueo. |
 
 Además, existe una restricción codificada:
 - **Espacio libre en disco < 5 GB** → el modo agresivo se habilita automáticamente (menor retención, umbrales más bajos).
@@ -148,38 +150,49 @@ Claude Guardian es **solo local**. No tiene ningún listener de red, ni telemetr
 
 **Lo que lee:** `~/.claude/projects/` (archivos de registro, tamaños, tiempos de modificación), lista de procesos (CPU, memoria, tiempo de actividad, recuentos de identificadores para los procesos relacionados con Claude a través de `pidusage`).
 
-**Lo que escribe:** `~/.claude-guardian/` (state.json, budget.json, journal.jsonl, paquetes de diagnóstico). Todos los archivos están ubicados en el directorio de inicio del usuario.
+**Qué escribe:** `~/.claude-guardian/` (state.json, budget.json, journal.jsonl, paquetes de información). Todos los archivos se encuentran en el directorio de inicio del usuario.
 
-**¿Qué información recopila en los paquetes?** Información del sistema (sistema operativo, CPU, memoria, disco), fragmentos de archivos de registro (las últimas 500 líneas), instantáneas de procesos y el propio registro de Guardian. No recopila claves de API, tokens, credenciales ni contenido de usuario.
+**Qué se recopila en los paquetes:** Información del sistema (sistema operativo, CPU, memoria, disco), fragmentos de archivos de registro (las últimas 500 líneas), instantáneas de procesos y el propio registro de Guardian. No se recopilan claves de API, tokens, credenciales ni contenido del usuario.
 
 **Acciones peligrosas: lo que Guardian NO hará:**
-- Matar procesos o enviar señales (no `SIGKILL`, no `SIGTERM`)
+- Terminar procesos o enviar señales (no `SIGKILL`, no `SIGTERM`)
 - Reiniciar Claude Code o cualquier otro proceso
-- Eliminar archivos (la rotación es mediante compresión gzip, el recorte consiste en mantener las últimas N líneas)
+- Eliminar archivos (la rotación se realiza mediante gzip, el recorte conserva las últimas N líneas)
 - Realizar solicitudes de red o enviar información a un servidor central
 - Aumentar privilegios o acceder a los datos de otros usuarios.
 
-Si alguna vez se añadiera la función de matar procesos o el reinicio automático, estará habilitada mediante una opción explícita, documentada aquí, y estará desactivada de forma predeterminada.
+Si alguna vez se agregara la función de terminar procesos o el reinicio automático, estará habilitada mediante una opción explícita, documentada aquí, y estará desactivada de forma predeterminada.
 
 ## Principios de diseño
 
-- **Evidencia sobre suposiciones** — cada acción genera una entrada en el registro; los paquetes de registro capturan el estado, no conjeturas.
-- **Determinista** — no utiliza aprendizaje automático ni heurísticas más allá de la edad y el tamaño de los archivos. Tabla de decisiones que se puede leer en 60 segundos.
-- **Seguro por defecto** — la rotación es mediante compresión gzip (reversible), el recorte consiste en mantener las últimas N líneas (los datos se conservan), no hay eliminaciones en la versión 1.
-- **Dependencias básicas** — commander, pidusage, archiver, @modelcontextprotocol/sdk. Eso es todo.
+- **Evidencia sobre suposiciones** — cada acción genera una entrada en el registro; los paquetes de información capturan el estado, no conjeturas.
+- **Determinista** — no utiliza aprendizaje automático, ni heurísticas más allá de la antigüedad y el tamaño de los archivos. Tabla de decisiones que se puede leer en 60 segundos.
+- **Seguro por defecto** — la rotación se realiza mediante gzip (reversible), el recorte conserva las últimas N líneas (los datos se conservan), no hay eliminaciones en la versión 1.
+- **Dependencias sencillas** — commander, pidusage, archiver, @modelcontextprotocol/sdk. Eso es todo.
 
 ## Desarrollo
 
-```bash
-npm install
-npm run build
-npm test
-```
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Cuadro de evaluación
+
+| Categoría | Puntuación | Notas |
+|----------|-------|-------|
+| A. Seguridad | 10/10 | SECURITY.md, solo local, sin telemetría, sin nube. |
+| B. Manejo de errores | 10/10 | GuardianError (código + pista + causa), errores estructurados de MCP, códigos de salida. |
+| C. Documentación para operadores | 10/10 | README, CHANGELOG, HANDBOOK, SHIP_GATE, guía paso a paso. |
+| D. Higiene en la entrega | 9/10 | CI + pruebas (152), publicado en npm, VSIX no disponible. |
+| E. Identidad | 10/10 | Logotipo, traducciones, página de inicio, listado en npm. |
+| **Total** | **49/50** | |
 
 ## Licencia
 
 MIT
 
----
+---
 
 Creado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>

package/README.fr.md

@@ -2,19 +2,21 @@
   <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.md">English</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
 </p>
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-guardian/readme.png" width="400" alt="claude-guardian" />
-</p>
-
-<p align="center">
-  <a href="https://github.com/mcp-tool-shop-org/claude-guardian/actions"><img src="https://github.com/mcp-tool-shop-org/claude-guardian/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
-  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License" /></a>
-  <a href="https://mcp-tool-shop-org.github.io/claude-guardian/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page" /></a>
-</p>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-guardian/readme.png" width="400" alt="claude-guardian" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/claude-guardian/actions"><img src="https://github.com/mcp-tool-shop-org/claude-guardian/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/claude-guardian"><img src="https://img.shields.io/npm/v/@mcptoolshop/claude-guardian" alt="npm" /></a>
+  <a href="https://codecov.io/gh/mcp-tool-shop-org/claude-guardian"><img src="https://img.shields.io/codecov/c/github/mcp-tool-shop-org/claude-guardian" alt="Coverage" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License" /></a>
+  <a href="https://mcp-tool-shop-org.github.io/claude-guardian/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page" /></a>
+</p>
 
 Ordinateur de bord pour Claude Code : rotation des journaux, surveillance, regroupement des erreurs, et auto-évaluation de l'environnement d'exécution (MCP).
 
-Claude Guardian est une couche de fiabilité locale qui maintient les sessions Claude Code en bon état. Il détecte les problèmes de taille des journaux, la saturation du disque et les blocages avant qu'ils ne causent des problèmes, enregistre les informations pertinentes en cas de problème, et expose un serveur MCP afin que Claude puisse s'auto-surveiller pendant les sessions.
+Claude Guardian est une couche de fiabilité locale qui maintient les sessions Claude Code en bon état. Il détecte les problèmes de taille des journaux, la saturation du disque et les blocages avant qu'ils ne causent des problèmes, il enregistre les informations pertinentes en cas de problème, et il expose un serveur MCP afin que Claude puisse s'auto-surveiller pendant les sessions.
 
 ## Ce qu'il fait
 
@@ -22,7 +24,7 @@ Claude Guardian est une couche de fiabilité locale qui maintient les sessions C
 |---------|---------|
 | `preflight` | Analyse les journaux du projet Claude, signale les répertoires/fichiers trop volumineux, corrige automatiquement (optionnel). |
 | `doctor` | Génère un ensemble de diagnostics (zip) contenant des informations système, les dernières lignes des journaux et un journal. |
-| `run -- <cmd>` | Exécute n'importe quelle commande avec surveillance, crée automatiquement un regroupement en cas de plantage/blocage. |
+| `run -- <cmd>` | Exécute n'importe quelle commande avec surveillance, crée un regroupement en cas de plantage/blocage. |
 | `status` | Vérification de l'état : espace disque disponible, taille des journaux, avertissements. |
 | `watch` | Démon en arrière-plan : surveillance continue, suivi des incidents, application des limites. |
 | `budget` | Affiche et gère la limite de concurrence (afficher/acquérir/libérer). |
@@ -30,89 +32,89 @@ Claude Guardian est une couche de fiabilité locale qui maintient les sessions C
 
 ## Installation
 
-```bash
-npm install -g claude-guardian
-```
+```bash
+npm install -g claude-guardian
+```
 
 Ou exécutez directement :
 
-```bash
-npx claude-guardian preflight
-```
+```bash
+npx claude-guardian preflight
+```
 
 ## Démarrage rapide
 
 ### Vérifiez votre environnement
 
-```bash
-claude-guardian status
-```
-
-```
-=== Claude Guardian Preflight ===
-
-Disk free: 607.13GB [OK]
-Claude projects: C:\Users\you\.claude\projects
-Total size: 1057.14MB
-
-Project directories (by size):
-  my-project: 1020.41MB
-
-Issues found:
-  [WARNING] Project log dir is 1020.41MB (limit: 200MB)
-  [WARNING] File is 33.85MB (limit: 25MB)
-
-[guardian] disk=607.13GB | logs=1057.14MB | issues=2
-```
+```bash
+claude-guardian status
+```
+
+```
+=== Claude Guardian Preflight ===
+
+Disk free: 607.13GB [OK]
+Claude projects: C:\Users\you\.claude\projects
+Total size: 1057.14MB
+
+Project directories (by size):
+  my-project: 1020.41MB
+
+Issues found:
+  [WARNING] Project log dir is 1020.41MB (limit: 200MB)
+  [WARNING] File is 33.85MB (limit: 25MB)
+
+[guardian] disk=607.13GB | logs=1057.14MB | issues=2
+```
 
 ### Corrige automatiquement les problèmes de taille des journaux
 
-```bash
-claude-guardian preflight --fix
-```
+```bash
+claude-guardian preflight --fix
+```
 
-Effectue la rotation des anciens journaux (gzip), réduit la taille des fichiers `.jsonl` et `.log` trop volumineux en ne conservant que les N dernières lignes. Chaque action est enregistrée dans un fichier journal pour la traçabilité.
+Effectue la rotation des anciens journaux (gzip), réduit la taille des fichiers `.jsonl` et `.log` trop volumineux en ne conservant que les N dernières lignes. Chaque action est enregistrée dans un fichier journal pour faciliter le suivi.
 
 ### Génère un rapport de plantage
 
-```bash
-claude-guardian doctor --out ./bundle.zip
-```
+```bash
+claude-guardian doctor --out ./bundle.zip
+```
 
 Crée un fichier zip contenant :
-- `summary.json` : informations système, rapport de taille des fichiers, résultats de vérification préliminaire.
+- `summary.json` : informations système, rapport de taille des fichiers, résultats de la vérification préliminaire.
 - `log-tails/` : les 500 dernières lignes de chaque fichier journal.
 - `journal.jsonl` : toutes les actions effectuées par le système de surveillance.
 
-### Exécute avec surveillance
+### Exécution avec surveillance
 
-```bash
-claude-guardian run -- claude
-claude-guardian run --auto-restart --hang-timeout 120 -- node server.js
-```
+```bash
+claude-guardian run -- claude
+claude-guardian run --auto-restart --hang-timeout 120 -- node server.js
+```
 
 La surveillance :
 1. Lance votre commande en tant que processus enfant.
-2. Surveille la sortie standard (stdout) et la sortie d'erreur (stderr) pour détecter l'activité.
-3. Si aucune activité pendant `--hang-timeout` secondes, un ensemble de diagnostics est créé.
-4. Si le processus plante, un ensemble est créé, et il peut être redémarré avec un délai progressif.
+2. Surveille les flux de sortie standard et d'erreur pour détecter l'activité.
+3. Si aucune activité pendant `--hang-timeout` secondes → crée un ensemble de diagnostics.
+4. Si le processus plante → crée un ensemble, redémarre éventuellement avec un délai progressif.
 
-## Serveur MCP (la véritable fonctionnalité)
+## Serveur MCP (la véritable clé)
 
 Enregistrez le système de surveillance en tant que serveur MCP local afin que Claude puisse s'auto-surveiller :
 
 Ajoutez ceci à `~/.claude.json` :
 
-```json
-{
-  "mcpServers": {
-    "guardian": {
-      "command": "npx",
-      "args": ["claude-guardian", "mcp"]
-    }
-  }
-}
-```
+```json
+{
+  "mcpServers": {
+    "guardian": {
+      "command": "npx",
+      "args": ["claude-guardian", "mcp"]
+    }
+  }
+}
+```
 
 Ensuite, Claude peut appeler :
 
@@ -120,7 +122,7 @@ Ensuite, Claude peut appeler :
 |------|----------------|
 | `guardian_status` | Espace disque, journaux, processus, risque de blocage, limite, niveau d'attention. |
 | `guardian_preflight_fix` | Effectue la rotation/réduction des journaux, renvoie un rapport avant/après. |
-| `guardian_doctor` | Crée un ensemble de diagnostics (zip), renvoie le chemin et un résumé. |
+| `guardian_doctor` | Crée un ensemble de diagnostics (zip), renvoie le chemin et le résumé. |
 | `guardian_nudge` | Correction automatique sécurisée : corrige les journaux s'ils sont trop volumineux, crée un ensemble si nécessaire. |
 | `guardian_budget_get` | Limite de concurrence actuelle, emplacements utilisés, licences actives. |
 | `guardian_budget_acquire` | Demande des emplacements de concurrence (renvoie l'ID de la licence). |
@@ -131,12 +133,12 @@ Cela permet à Claude de dire : "L'attention est à niveau AVERTISSEMENT. Exécu
 
 ## Configuration
 
-Trois paramètres (tout le reste est codé en dur avec des valeurs par défaut raisonnables) :
+Trois paramètres (le reste est codé en dur avec des valeurs par défaut raisonnables) :
 
 | Paramètre | Valeur par défaut | Description |
 |------|---------|-------------|
 | `--max-log-mb` | `200` | Taille maximale du répertoire des journaux du projet en Mo. |
-| `--hang-timeout` | `300` | Nombre de secondes d'inactivité avant de déclarer un blocage. |
+| `--hang-timeout` | `300` | Nombre de secondes d'inactivité avant de signaler un blocage. |
 | `--auto-restart` | `false` | Redémarrage automatique en cas de plantage/blocage. |
 
 Plus une règle de sécurité codée en dur :
@@ -148,14 +150,14 @@ Claude Guardian est **local uniquement**. Il n'a pas de listener réseau, de té
 
 **Ce qu'il lit :** `~/.claude/projects/` (fichiers journaux, tailles, dates de modification), liste des processus (utilisation du CPU, mémoire, temps de fonctionnement, nombre de descripteurs pour les processus liés à Claude via `pidusage`).
 
-**Ce qu'il écrit :** `~/.claude-guardian/` (state.json, budget.json, journal.jsonl, doctor bundles). Tous les fichiers se trouvent dans le répertoire personnel de l'utilisateur.
+**Ce qu'il écrit :** `~/.claude-guardian/` (state.json, budget.json, journal.jsonl, ensembles de données). Tous les fichiers se trouvent dans le répertoire personnel de l'utilisateur.
 
-**Ce qu'il collecte dans les rapports :** Informations système (OS, CPU, mémoire, disque), extraits de fichiers journaux (les 500 dernières lignes), instantanés des processus et le propre journal de Guardian. Aucune clé API, aucun jeton, aucune identifiant, ni aucun contenu utilisateur.
+**Ce qu'il collecte dans les ensembles de données :** Informations système (OS, CPU, mémoire, disque), extraits de fichiers journaux (les 500 dernières lignes), instantanés de processus et le propre journal de Guardian. Aucune clé API, aucun jeton, aucune identifiant ou aucun contenu utilisateur.
 
 **Actions dangereuses — ce que Guardian NE fera PAS :**
 - Terminer des processus ou envoyer des signaux (pas de `SIGKILL`, pas de `SIGTERM`)
 - Redémarrer Claude Code ou tout autre processus
-- Supprimer des fichiers (la rotation se fait par compression gzip, la suppression se limite aux N dernières lignes)
+- Supprimer des fichiers (rotation = gzip, suppression = conserver les N dernières lignes)
 - Effectuer des requêtes réseau ou contacter un serveur central
 - Accorder des privilèges supérieurs ou accéder aux données d'autres utilisateurs
 
@@ -163,23 +165,34 @@ Si la terminaison de processus ou le redémarrage automatique étaient un jour a
 
 ## Principes de conception
 
-- **Preuves plutôt que suppositions** — chaque action génère une entrée de journal ; les rapports capturent l'état, et non des conjectures.
+- **Preuves plutôt que suppositions** — chaque action enregistre une entrée de journal ; les ensembles de données en cas de crash capturent l'état, et non des hypothèses.
 - **Déterministe** — pas d'apprentissage automatique, pas d'heuristiques au-delà de l'âge et de la taille des fichiers. Tableau de décision que vous pouvez lire en 60 secondes.
-- **Sûr par défaut** — la rotation se fait par compression gzip (réversible), la suppression se limite aux N dernières lignes (les données sont préservées), aucune suppression dans la version 1.
+- **Sûr par défaut** — rotation = gzip (réversible), suppression = conserver les N dernières lignes (données préservées), aucune suppression dans la version 1.
 - **Dépendances simples** — commander, pidusage, archiver, @modelcontextprotocol/sdk. C'est tout.
 
 ## Développement
 
-```bash
-npm install
-npm run build
-npm test
-```
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Tableau de bord
+
+| Catégorie | Score | Notes |
+|----------|-------|-------|
+| A. Sécurité | 10/10 | SECURITY.md, uniquement local, pas de télémétrie, pas de cloud |
+| B. Gestion des erreurs | 10/10 | GuardianError (code + indication + cause), erreurs MCP structurées, codes de sortie |
+| C. Documentation pour les administrateurs | 10/10 | README, CHANGELOG, HANDBOOK, SHIP_GATE, guide pas à pas |
+| D. Qualité du code | 9/10 | CI + tests (152), publié sur npm, VSIX n/a |
+| E. Identité | 10/10 | Logo, traductions, page d'accueil, inscription npm |
+| **Total** | **49/50** | |
 
 ## Licence
 
 MIT
 
----
+---
 
 Créé par <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>