@mcptoolshop/registry-stats 2.0.0 → 2.2.0

package/README.fr.md

@@ -1,15 +1,15 @@
-<p align="center">
-  <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">
+  <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/registry-stats/readme.png" alt="registry-stats logo" width="400" />
 </p>
-
+
 <p align="center">
   Five registries. One engine. Dashboard included.
 </p>
-
+
 <p align="center">
   <a href="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.yml"><img src="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.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>
@@ -17,7 +17,7 @@
   <a href="https://mcp-tool-shop-org.github.io/registry-stats/dashboard/"><img src="https://img.shields.io/badge/Dashboard-live-green" alt="Dashboard"></a>
   <a href="https://mcp-tool-shop-org.github.io/registry-stats/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
 </p>
-
+
 <p align="center">
   <a href="#dashboard">Dashboard</a> &middot;
   <a href="#desktop-app">Desktop App</a> &middot;
@@ -28,53 +28,57 @@
   <a href="#config-file">Config</a> &middot;
   <a href="#license">License</a>
 </p>
-
+
 ---
-
-Vous publiez sur npm, PyPI, NuGet, le Marketplace de VS Code et Docker Hub. Actuellement, répondre à la question "comment vont mes paquets ?" nécessite de consulter cinq sites différents. **registry-stats** est une plateforme complète : un moteur TypeScript (CLI + API + serveur REST), un tableau de bord web interactif et une application de bureau Windows native, le tout regroupé dans un seul dépôt.
-
-Aucune dépendance d'exécution. Utilise la fonction native `fetch()`. Node 18+.
-
-## Contenu
-
-| Couche | Fonctionnalités |
-|-------|-------------|
-| **Engine** | Bibliothèque TypeScript + CLI + serveur REST. Interrogez cinq registres avec une seule interface. Publié sur npm sous le nom `@mcptoolshop/registry-stats`. |
-| **Dashboard** | Application web basée sur Astro. Aperçus, indicateurs de croissance, état des données, classement avec des graphiques. Reconstruite chaque semaine par CI. |
-| **Desktop** | Application Windows native utilisant WinUI 3 + WebView2. Inclut le tableau de bord hors ligne et récupère les statistiques en direct à la demande. |
-
-## Tableau de bord
-
-Un tableau de bord de statistiques qui se met à jour automatiquement est disponible à l'adresse [`/dashboard/`](https://mcp-tool-shop-org.github.io/registry-stats/dashboard/).
-
-- **Aperçu** — récit hebdomadaire en une phrase : registre principal, paquet principal, progression la plus importante, répartition des paquets, fiabilité des données.
-- **Indicateurs de croissance** — paquets avec la progression la plus importante, les baisses les plus importantes et les nouveaux paquets actifs (npm sur 7 jours par rapport aux 7 jours précédents).
-- **État des données** — couverture par registre, badges de fiabilité (OK / partiel / manquant), détails des erreurs pouvant être développés.
-- **Évolution des données** — suivi semaine par semaine pour les registres cumulatifs uniquement (Docker, VS Code, NuGet).
-- **Classement** — tous les paquets classés par nombre de téléchargements hebdomadaires, avec des graphiques sur 30 jours pour chaque ligne.
-- **Thème clair/sombre** — suit les préférences du système.
-
-Les données sont récupérées au moment de la construction et le tableau de bord est reconstruit chaque semaine par CI (lundi à 06h00 UTC). Configurez les paquets suivis dans `site/src/data/packages.json`.
-
-## Application de bureau
-
-Une application Windows native qui intègre le tableau de bord dans un environnement WebView2 local :
-
-- **Fonctionne hors ligne** — inclut les fichiers HTML/CSS/JS ; fonctionne sans connexion Internet.
-- **Actualisation en direct** — récupère le fichier `stats.json` depuis GitHub Pages à la demande.
-- **Exportation CSV** — exportez les données du classement en un seul clic.
-- **Paquet MSIX** — construit et signé par CI via `desktop-ci.yml`.
-
-Le code source de l'application de bureau se trouve dans le répertoire `desktop/`. Développé avec .NET 10 MAUI et ciblant WinUI 3.
-
-## Installer
-
+
+Vous publiez sur npm, PyPI, NuGet, le Marketplace de VS Code et Docker Hub. Actuellement, répondre à la question "comment vont mes paquets ?" nécessite de consulter cinq sites différents. **registry-stats** est une plateforme complète : un moteur TypeScript (CLI + API + serveur REST), un tableau de bord web interactif et une application de bureau Windows native, le tout regroupé dans un seul dépôt.
+
+Aucune dépendance d'exécution. Utilise la fonction native `fetch()`. Node 18+.
+
+## Contenu
+
+| Couche | Fonctionnalités |
+|-------|-------------|
+| **Engine** | Bibliothèque TypeScript + CLI + serveur REST. Interrogez cinq registres avec une seule interface. Publié sur npm sous le nom `@mcptoolshop/registry-stats`. |
+| **Dashboard** | Application web basée sur Astro. Assistant de chat IA, six graphiques interactifs, moteur de croissance intelligent et guide d'aide avec onglets. Reconstruite chaque semaine par CI. |
+| **Desktop** | Application Windows native utilisant WinUI 3 + WebView2. Inclut le tableau de bord hors ligne et récupère les statistiques en direct à la demande. |
+
+## Tableau de bord
+
+Un tableau de bord de statistiques qui se met à jour automatiquement est disponible à l'adresse [`/dashboard/`](https://mcp-tool-shop-org.github.io/registry-stats/dashboard/).
+
+- **Interface à onglets** — Onglets Home, Analytics, Leaderboard et Help
+- **Assistant de chat IA** — Registry Assistant alimenté par Ollama avec contexte RAG, réponses en streaming, sélecteur de modèles et mémoire de conversation
+- **Résumé exécutif** — score de santé (0–100), indice de diversité, variation hebdomadaire, téléchargements totaux sur tous les registres
+- **Six graphiques interactifs** — tendance sur 30 jours (vue agrégée / par registre / top 5), part des registres (aire polaire), risque du portefeuille (histogramme + Gini & P90), top 10 momentum, suivi de la vélocité avec sparklines, et carte thermique 30 jours avec détection de pics (>2σ)
+- **Moteur de croissance intelligent** — gère la distorsion des petits dénominateurs avec seuil de référence, plafonnement du pourcentage et formule de vélocité amortie
+- **Perspectives exploitables** — recommandations auto-générées et alertes d'attention pour les paquets en déclin
+- **Classement** — tous les paquets classés par téléchargements hebdomadaires avec sparklines sur 30 jours et badges de tendance intelligents
+- **Page de configuration** — éditeur de portefeuille avec validation, section registry-sync et vue d'ensemble du pipeline
+- **Onglet d'aide** — guide convivial couvrant chaque onglet, les concepts clés, les conseils pour l'assistant IA, le pipeline de données et les liens utiles
+- **Thème clair/sombre** — suit les préférences du système
+
+Les données sont récupérées au moment de la construction et le tableau de bord est reconstruit chaque semaine par CI (lundi à 06h00 UTC). Configurez les paquets suivis dans `site/src/data/packages.json`.
+
+## Application de bureau
+
+Une application Windows native qui intègre le tableau de bord dans un environnement WebView2 local :
+
+- **Fonctionne hors ligne** — inclut les fichiers HTML/CSS/JS ; fonctionne sans connexion Internet.
+- **Actualisation en direct** — récupère le fichier `stats.json` depuis GitHub Pages à la demande.
+- **Exportation CSV** — exportez les données du classement en un seul clic.
+- **Paquet MSIX** — construit et signé par CI via `desktop-ci.yml`.
+
+Le code source de l'application de bureau se trouve dans le répertoire `desktop/`. Développé avec .NET 10 MAUI et ciblant WinUI 3.
+
+## Installer
+
 ```bash
 npm install @mcptoolshop/registry-stats
 ```
-
-## CLI
-
+
+## CLI
+
 ```bash
 # Query a single registry
 registry-stats express -r npm
@@ -112,11 +116,11 @@ registry-stats express -r npm --range 2025-01-01:2025-06-30 --format chart
 # Start a REST API server
 registry-stats serve --port 3000
 ```
-
-## Fichier de configuration
-
-Créez un fichier `registry-stats.config.json` à la racine de votre projet (ou exécutez la commande `registry-stats --init`) :
-
+
+## Fichier de configuration
+
+Créez un fichier `registry-stats.config.json` à la racine de votre projet (ou exécutez la commande `registry-stats --init`) :
+
 ```json
 {
   "registries": ["npm", "pypi", "nuget", "vscode", "docker"],
@@ -135,11 +139,11 @@ Créez un fichier `registry-stats.config.json` à la racine de votre projet (ou
   "concurrency": 5
 }
 ```
-
-Exécutez la commande `registry-stats` sans arguments pour obtenir les statistiques de tous les paquets configurés. L'interface en ligne de commande (CLI) remonte à partir du répertoire de travail actuel (cwd) pour trouver le fichier de configuration le plus proche.
-
-La configuration est également accessible par programmation :
-
+
+Exécutez la commande `registry-stats` sans arguments pour obtenir les statistiques de tous les paquets configurés. L'interface en ligne de commande (CLI) remonte à partir du répertoire de travail actuel (cwd) pour trouver le fichier de configuration le plus proche.
+
+La configuration est également accessible par programmation :
+
 ```typescript
 import { loadConfig, defaultConfig, starterConfig } from '@mcptoolshop/registry-stats';
 
@@ -147,9 +151,9 @@ const config = loadConfig();          // finds nearest config file, or null
 const defaults = defaultConfig();     // returns default Config object
 const template = starterConfig();     // returns starter JSON string
 ```
-
-## API programmable
-
+
+## API programmable
+
 ```typescript
 import { stats, calc, createCache } from '@mcptoolshop/registry-stats';
 
@@ -190,41 +194,41 @@ const cache = createCache();
 await stats('npm', 'express', { cache });  // fetches
 await stats('npm', 'express', { cache });  // cache hit
 ```
-
-## Support technique pour les registres
-
-| Registre. | Format du paquet. | Séries temporelles. | Données disponibles. |
-|----------|---------------|-------------|----------------|
-| `npm` | `express`, `@scope/pkg` | Oui (549 jours). | dernier jour, dernière semaine, dernier mois. |
-| `pypi` | `requests` | Oui (180 jours). | dernier jour, dernière semaine, dernier mois, total. |
-| `nuget` | `Newtonsoft.Json` | No | total |
-| `vscode` | `publisher.extension` | No | total (installations), évaluation, tendances. |
-| `docker` | `namespace/repo` | No | total (nombre de tirages), étoiles. |
-
-## Fiabilité intégrée
-
-- Nouvelle tentative automatique avec un délai exponentiel en cas d'erreurs 429/5xx.
-- Respect des en-têtes "Retry-After".
-- Limitation de la concurrence pour les requêtes groupées.
-- Cache TTL optionnel (extensible – possibilité d'utiliser votre propre backend Redis ou fichier via l'interface "StatsCache").
-
-## Serveur d'API REST
-
-Fonctionnez en tant que microservice ou intégrez-le à votre propre serveur :
-
+
+## Support technique pour les registres
+
+| Registre. | Format du paquet. | Séries temporelles. | Données disponibles. |
+|----------|---------------|-------------|----------------|
+| `npm` | `express`, `@scope/pkg` | Oui (549 jours). | dernier jour, dernière semaine, dernier mois. |
+| `pypi` | `requests` | Oui (180 jours). | dernier jour, dernière semaine, dernier mois, total. |
+| `nuget` | `Newtonsoft.Json` | No | total |
+| `vscode` | `publisher.extension` | No | total (installations), évaluation, tendances. |
+| `docker` | `namespace/repo` | No | total (nombre de tirages), étoiles. |
+
+## Fiabilité intégrée
+
+- Nouvelle tentative automatique avec un délai exponentiel en cas d'erreurs 429/5xx.
+- Respect des en-têtes "Retry-After".
+- Limitation de la concurrence pour les requêtes groupées.
+- Cache TTL optionnel (extensible – possibilité d'utiliser votre propre backend Redis ou fichier via l'interface "StatsCache").
+
+## Serveur d'API REST
+
+Fonctionnez en tant que microservice ou intégrez-le à votre propre serveur :
+
 ```bash
 registry-stats serve --port 3000
 ```
-
+
 ```
 GET /stats/:package              # all registries
 GET /stats/:registry/:package    # single registry
 GET /compare/:package?registries=npm,pypi
 GET /range/:registry/:package?start=YYYY-MM-DD&end=YYYY-MM-DD&format=json|csv|chart
 ```
-
-Utilisation par programmation pour les serveurs personnalisés ou les environnements sans serveur :
-
+
+Utilisation par programmation pour les serveurs personnalisés ou les environnements sans serveur :
+
 ```typescript
 import { createHandler, serve } from '@mcptoolshop/registry-stats';
 
@@ -236,9 +240,9 @@ import { createServer } from 'node:http';
 const handler = createHandler();
 createServer(handler).listen(3000);
 ```
-
-## Registres personnalisés
-
+
+## Registres personnalisés
+
 ```typescript
 import { registerProvider, type RegistryProvider } from '@mcptoolshop/registry-stats';
 
@@ -259,9 +263,9 @@ const cargo: RegistryProvider = {
 registerProvider(cargo);
 await stats('cargo', 'serde');
 ```
-
-## Structure du dépôt
-
+
+## Structure du dépôt
+
 ```
 registry-stats/
 ├── src/        # TypeScript engine (published to npm)
@@ -269,9 +273,9 @@ registry-stats/
 ├── desktop/    # WinUI 3 desktop app (.NET 10 MAUI)
 └── test/       # Library tests (vitest)
 ```
-
-## Développement
-
+
+## Développement
+
 ```bash
 # Engine
 npm install && npm run build && npm test
@@ -282,36 +286,36 @@ npm run site:dev
 # Dashboard (production build)
 npm run site:build
 ```
-
-## Sécurité et portée des données
-
-| Aspect | Détail |
-|--------|--------|
-| **Data touched** | Statistiques de téléchargement publiques provenant de npm, PyPI, NuGet, VS Code Marketplace, Docker Hub. Cache en mémoire (facultatif). |
-| **Data NOT touched** | Aucune télémétrie. Aucune analyse. Aucun stockage d'informations d'identification. Aucune donnée utilisateur. Aucune écriture de fichiers. |
-| **Permissions** | Lecture : API publiques des registres via HTTPS. Écriture : uniquement vers la sortie standard/erreur standard. |
-| **Network** | Sorties HTTPS vers les API publiques des registres. Serveur REST localhost facultatif. |
-| **Telemetry** | Aucune donnée collectée ou envoyée. |
-
-Consultez le fichier [SECURITY.md](SECURITY.md) pour signaler les vulnérabilités.
-
-## Tableau de bord
-
-| Catégorie | Score |
-|----------|-------|
-| A. Sécurité | 10 |
-| B. Gestion des erreurs | 10 |
-| C. Documentation pour les administrateurs | 10 |
-| D. Bonnes pratiques de déploiement | 10 |
-| E. Identité (facultatif) | 10 |
-| **Overall** | **50/50** |
-
-> Audit complet : [SHIP_GATE.md](SHIP_GATE.md) · [SCORECARD.md](SCORECARD.md)
-
-## Licence
-
-MIT.
-
+
+## Sécurité et portée des données
+
+| Aspect | Détail |
+|--------|--------|
+| **Data touched** | Statistiques de téléchargement publiques provenant de npm, PyPI, NuGet, VS Code Marketplace, Docker Hub. Cache en mémoire (facultatif). |
+| **Data NOT touched** | Aucune télémétrie. Aucune analyse. Aucun stockage d'informations d'identification. Aucune donnée utilisateur. Aucune écriture de fichiers. |
+| **Permissions** | Lecture : API publiques des registres via HTTPS. Écriture : uniquement vers la sortie standard/erreur standard. |
+| **Network** | Sorties HTTPS vers les API publiques des registres. Serveur REST localhost facultatif. |
+| **Telemetry** | Aucune donnée collectée ou envoyée. |
+
+Consultez le fichier [SECURITY.md](SECURITY.md) pour signaler les vulnérabilités.
+
+## Tableau de bord
+
+| Catégorie | Score |
+|----------|-------|
+| A. Sécurité | 10 |
+| B. Gestion des erreurs | 10 |
+| C. Documentation pour les administrateurs | 10 |
+| D. Bonnes pratiques de déploiement | 10 |
+| E. Identité (facultatif) | 10 |
+| **Overall** | **50/50** |
+
+> Audit complet : [SHIP_GATE.md](SHIP_GATE.md) · [SCORECARD.md](SCORECARD.md)
+
+## Licence
+
+MIT.
+
 ---
-
-Construit par <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>.
+
+Construit par <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>.