npm - @mcptoolshop/registry-stats - Versions diffs - 1.2.4 → 2.1.0 - Mend

@mcptoolshop/registry-stats 1.2.4 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.es.md CHANGED Viewed

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <strong>Español</strong> | <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</a>
+  <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">
@@ -7,31 +7,69 @@
 </p>
 <p align="center">
-  One command. Five registries. All your download stats.
+  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>
   <a href="https://www.npmjs.com/package/@mcptoolshop/registry-stats"><img src="https://img.shields.io/npm/v/@mcptoolshop/registry-stats" alt="npm version"></a>
+  <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="https://mcp-tool-shop-org.github.io/registry-stats/">Docs</a> &middot;
+  <a href="#dashboard">Dashboard</a> &middot;
+  <a href="#desktop-app">Desktop App</a> &middot;
   <a href="#install">Install</a> &middot;
   <a href="#cli">CLI</a> &middot;
-  <a href="#config-file">Config</a> &middot;
   <a href="#programmatic-api">API</a> &middot;
   <a href="#rest-api-server">REST Server</a> &middot;
+  <a href="#config-file">Config</a> &middot;
   <a href="#license">License</a>
 </p>
 ---
-Si publicas en npm, PyPI, NuGet, el Marketplace de VS Code o Docker Hub, actualmente necesitas cinco API diferentes para responder a la pregunta "¿cuántas descargas he tenido este mes?". Esta biblioteca te proporciona una única interfaz para todas ellas, ya sea como una herramienta de línea de comandos (CLI) o como una API programática.
+Publica en npm, PyPI, NuGet, el Marketplace de VS Code y Docker Hub. Actualmente, responder a la pregunta "¿cómo le están yendo a mis paquetes?" implica consultar cinco sitios diferentes. **registry-stats** es la plataforma completa: un motor de TypeScript (CLI + API + servidor REST), un panel web en tiempo real y una aplicación de escritorio nativa para Windows, todo desde un único repositorio.
+No tiene dependencias de tiempo de ejecución. Utiliza `fetch()` nativo. Node 18+.
+## ¿Qué hay dentro?
+| Capa | ¿Qué hace? |
+|-------|-------------|
+| **Engine** | Biblioteca de TypeScript + CLI + servidor REST. Consulta cinco registros con una única interfaz. Publicado en npm como `@mcptoolshop/registry-stats`. |
+| **Dashboard** | Aplicación web impulsada por Astro. Asistente de chat con IA, seis gráficos interactivos, motor de crecimiento inteligente y guía de ayuda con pestañas. Se reconstruye semanalmente mediante CI. |
+| **Desktop** | Aplicación nativa para Windows con WinUI 3 + WebView2. Incluye el panel sin conexión y descarga las estadísticas en tiempo real bajo demanda. |
+## Panel
+Un panel de estadísticas que se actualiza automáticamente se encuentra en [`/dashboard/`](https://mcp-tool-shop-org.github.io/registry-stats/dashboard/).
-Sin dependencias. Utiliza la función nativa `fetch()`. Node 18+.
+- **Interfaz con pestañas** — Pestañas Home, Analytics, Leaderboard y Help
+- **Asistente de chat con IA** — Registry Assistant con Ollama, contexto RAG, respuestas en streaming, selector de modelos y memoria de conversación
+- **Resumen ejecutivo** — puntuación de salud (0–100), índice de diversidad, variación semanal, descargas totales de todos los registros
+- **Seis gráficos interactivos** — tendencia de 30 días (vista agregada / por registro / top 5), cuota de registro (área polar), riesgo del portafolio (histograma + Gini & P90), top 10 de momentum, rastreador de velocidad con sparklines, y mapa de calor de 30 días con detección de picos (>2σ)
+- **Motor de crecimiento inteligente** — maneja la distorsión por denominadores pequeños con umbral base, límite de porcentaje y fórmula de velocidad amortiguada
+- **Perspectivas accionables** — recomendaciones autogeneradas y alertas para paquetes en declive
+- **Tabla de clasificación** — todos los paquetes clasificados por descargas semanales con sparklines de 30 días y badges de tendencia inteligente
+- **Página de configuración** — editor de portafolio con validación, sección de registry-sync y vista general del flujo de datos
+- **Pestaña de ayuda** — guía amigable que cubre cada pestaña, conceptos clave, consejos del asistente IA, flujo de datos y enlaces útiles
+- **Tema claro/oscuro** — Sigue la preferencia del sistema
+Los datos se obtienen en el momento de la compilación y se reconstruyen semanalmente mediante CI (los lunes a las 06:00 UTC). Configure los paquetes rastreados en `site/src/data/packages.json`.
+## Aplicación de escritorio
+Una aplicación nativa para Windows que integra el panel en un entorno WebView2 local:
+- **Funciona sin conexión** — Incluye HTML/CSS/JS empaquetados; funciona sin internet.
+- **Actualización en tiempo real** — Descarga `stats.json` de GitHub Pages bajo demanda.
+- **Exportación a CSV** — Exporta los datos de la tabla de clasificación con un solo clic.
+- **Empaquetado MSIX** — Se construye y firma en CI mediante `desktop-ci.yml`.
+El código fuente de la aplicación de escritorio se encuentra en `desktop/`. Se construyó con .NET 10 MAUI y apunta a WinUI 3.
 ## Instalación
@@ -52,10 +90,6 @@ registry-stats express
 # Time series with monthly breakdown + trend
 registry-stats express -r npm --range 2025-01-01:2025-06-30
-#  2025-01  142,359,021
-#  2025-02  147,522,528
-#  ...
-#  Total: 448,383,383  Avg/day: 4,982,038  Trend: flat (-0.46%)
 # Raw JSON output
 registry-stats express -r npm --json
@@ -74,14 +108,6 @@ registry-stats
 # Compare across registries
 registry-stats express --compare
-#  express — comparison
-#
-#  Metric        npm         pypi
-#  ─────────────────────────────────
-#  Total         -           -
-#  Month         283,472     47,201
-#  Week          67,367      11,800
-#  Day           11,566      1,686
 # Export as CSV or chart-friendly JSON
 registry-stats express -r npm --range 2025-01-01:2025-06-30 --format csv
@@ -161,7 +187,6 @@ calc.toChartData(daily, 'express');        // { labels: [...], datasets: [{ labe
 // Comparison — same package across registries
 const comparison = await stats.compare('express');
-// → { package: 'express', registries: { npm: {...}, pypi: {...} }, fetchedAt: '...' }
 await stats.compare('express', ['npm', 'pypi']);  // specific registries only
 // Caching (5 min TTL, in-memory)
@@ -173,7 +198,7 @@ await stats('npm', 'express', { cache });  // cache hit
 ## Soporte para registros
 | Registro | Formato del paquete | Series de tiempo | Datos disponibles |
-| ---------- | --------------- | ------------- | ---------------- |
+|----------|---------------|-------------|----------------|
 | `npm` | `express`, `@scope/pkg` | Sí (549 días) | último día, última semana, último mes |
 | `pypi` | `requests` | Sí (180 días) | último día, última semana, último mes, total |
 | `nuget` | `Newtonsoft.Json` | No | total |
@@ -192,7 +217,6 @@ await stats('npm', 'express', { cache });  // cache hit
 Ejecútalo como un microservicio o intégralo en tu propio servidor:
 ```bash
-# CLI
 registry-stats serve --port 3000
 ```
@@ -240,13 +264,53 @@ registerProvider(cargo);
 await stats('cargo', 'serde');
 ```
-## Sitio web
+## Estructura del repositorio
+```
+registry-stats/
+├── src/        # TypeScript engine (published to npm)
+├── site/       # Astro dashboard + landing page (deployed to GitHub Pages)
+├── desktop/    # WinUI 3 desktop app (.NET 10 MAUI)
+└── test/       # Library tests (vitest)
+```
+## Desarrollo
+```bash
+# Engine
+npm install && npm run build && npm test
+# Dashboard (dev server)
+npm run site:dev
+# Dashboard (production build)
+npm run site:build
+```
+## Seguridad y alcance de los datos
+| Aspecto | Detalle |
+|--------|--------|
+| **Data touched** | Estadísticas de descarga pública de npm, PyPI, NuGet, Marketplace de VS Code, Docker Hub. Caché en memoria (opcional). |
+| **Data NOT touched** | Sin telemetría. Sin análisis. Sin almacenamiento de credenciales. Sin datos de usuario. Sin escrituras de archivos. |
+| **Permissions** | Lectura: APIs públicas de registros a través de HTTPS. Escritura: solo stdout/stderr. |
+| **Network** | Conexiones HTTPS salientes a APIs públicas de registros. Servidor REST opcional en localhost. |
+| **Telemetry** | Ninguno recopilado ni enviado. |
+Consulte [SECURITY.md](SECURITY.md) para informar sobre vulnerabilidades.
+## Tabla de puntuación
-La documentación y la página de inicio se encuentran en el directorio `site/`.
+| Categoría | Puntuación |
+|----------|-------|
+| A. Seguridad | 10 |
+| B. Manejo de errores | 10 |
+| C. Documentación para operadores | 10 |
+| D. Higiene de implementación | 10 |
+| E. Identidad (suave) | 10 |
+| **Overall** | **50/50** |
-- Desarrollo: `npm run site:dev`
-- Compilación: `npm run site:build`
-- Previsualización: `npm run site:preview`
+> Auditoría completa: [SHIP_GATE.md](SHIP_GATE.md) · [SCORECARD.md](SCORECARD.md)
 ## Licencia

package/README.fr.md CHANGED Viewed

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <strong>Français</strong> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português</a>
+  <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">
@@ -7,31 +7,69 @@
 </p>
 <p align="center">
-  One command. Five registries. All your download stats.
+  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>
   <a href="https://www.npmjs.com/package/@mcptoolshop/registry-stats"><img src="https://img.shields.io/npm/v/@mcptoolshop/registry-stats" alt="npm version"></a>
+  <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="https://mcp-tool-shop-org.github.io/registry-stats/">Docs</a> &middot;
+  <a href="#dashboard">Dashboard</a> &middot;
+  <a href="#desktop-app">Desktop App</a> &middot;
   <a href="#install">Install</a> &middot;
   <a href="#cli">CLI</a> &middot;
-  <a href="#config-file">Config</a> &middot;
   <a href="#programmatic-api">API</a> &middot;
   <a href="#rest-api-server">REST Server</a> &middot;
+  <a href="#config-file">Config</a> &middot;
   <a href="#license">License</a>
 </p>
 ---
-Si vous publiez sur npm, PyPI, NuGet, le marché de VS Code ou Docker Hub, vous avez actuellement besoin de cinq API différentes pour répondre à la question : "Combien de téléchargements ai-je eu ce mois-ci ?" Cette bibliothèque vous offre une interface unique pour tous ces services, sous forme d'interface en ligne de commande ou d'API programmatique.
+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/).
-Aucune dépendance. Utilise la fonction native `fetch()`. Compatible avec Node 18 et versions ultérieures.
+- **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
@@ -52,10 +90,6 @@ registry-stats express
 # Time series with monthly breakdown + trend
 registry-stats express -r npm --range 2025-01-01:2025-06-30
-#  2025-01  142,359,021
-#  2025-02  147,522,528
-#  ...
-#  Total: 448,383,383  Avg/day: 4,982,038  Trend: flat (-0.46%)
 # Raw JSON output
 registry-stats express -r npm --json
@@ -74,14 +108,6 @@ registry-stats
 # Compare across registries
 registry-stats express --compare
-#  express — comparison
-#
-#  Metric        npm         pypi
-#  ─────────────────────────────────
-#  Total         -           -
-#  Month         283,472     47,201
-#  Week          67,367      11,800
-#  Day           11,566      1,686
 # Export as CSV or chart-friendly JSON
 registry-stats express -r npm --range 2025-01-01:2025-06-30 --format csv
@@ -161,7 +187,6 @@ calc.toChartData(daily, 'express');        // { labels: [...], datasets: [{ labe
 // Comparison — same package across registries
 const comparison = await stats.compare('express');
-// → { package: 'express', registries: { npm: {...}, pypi: {...} }, fetchedAt: '...' }
 await stats.compare('express', ['npm', 'pypi']);  // specific registries only
 // Caching (5 min TTL, in-memory)
@@ -173,45 +198,7 @@ await stats('npm', 'express', { cache });  // cache hit
 ## Support technique pour les registres
 | Registre. | Format du paquet. | Séries temporelles. | Données disponibles. |
-| Bien sûr, veuillez me fournir le texte que vous souhaitez que je traduise. | "The quick brown fox jumps over the lazy dog."
-"This is a sample text."
-"Please provide more context."
-"Thank you for your cooperation."
-"We look forward to hearing from you soon."
-"The meeting will be held on Tuesday."
-"The deadline is Friday."
-"Please contact us if you have any questions."
-"We are committed to providing excellent service."
-"Your satisfaction is our priority."
----------------
-"Le rapide renard brun saute par-dessus le chien paresseux."
-"Ceci est un exemple de texte."
-"Veuillez fournir plus de contexte."
-"Nous vous remercions de votre coopération."
-"Nous espérons avoir de vos nouvelles prochainement."
-"La réunion se tiendra le mardi."
-"La date limite est le vendredi."
-"N'hésitez pas à nous contacter si vous avez des questions."
-"Nous nous engageons à fournir un excellent service."
-"Votre satisfaction est notre priorité." | "Please provide the text you would like me to translate." | "The company is committed to providing high-quality products and services."
-"We are looking for a motivated and experienced candidate."
-"The meeting will take place on Tuesday at 2:00 PM."
-"Please submit your application by the end of the week."
-"For more information, please contact us."
-----------------
-"L'entreprise s'engage à fournir des produits et services de haute qualité."
-"Nous recherchons un candidat motivé et expérimenté."
-"La réunion aura lieu mardi à 14h00."
-"Veuillez soumettre votre candidature avant la fin de la semaine."
-"Pour plus d'informations, veuillez nous contacter." |
+|----------|---------------|-------------|----------------|
 | `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 |
@@ -230,7 +217,6 @@ await stats('npm', 'express', { cache });  // cache hit
 Fonctionnez en tant que microservice ou intégrez-le à votre propre serveur :
 ```bash
-# CLI
 registry-stats serve --port 3000
 ```
@@ -278,13 +264,53 @@ registerProvider(cargo);
 await stats('cargo', 'serde');
 ```
-## Site web
+## Structure du dépôt
+```
+registry-stats/
+├── src/        # TypeScript engine (published to npm)
+├── site/       # Astro dashboard + landing page (deployed to GitHub Pages)
+├── desktop/    # WinUI 3 desktop app (.NET 10 MAUI)
+└── test/       # Library tests (vitest)
+```
+## Développement
+```bash
+# Engine
+npm install && npm run build && npm test
+# Dashboard (dev server)
+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
-Les pages de documentation et la page d'accueil se trouvent dans le répertoire `site/`.
+| 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** |
-- Développement : `npm run site:dev`
-- Construction : `npm run site:build`
-- Aperçu : `npm run site:preview`
+> Audit complet : [SHIP_GATE.md](SHIP_GATE.md) · [SCORECARD.md](SCORECARD.md)
 ## Licence

package/README.hi.md CHANGED Viewed

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <strong>हिन्दी</strong> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português</a>
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.md">English</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
 </p>
 <p align="center">
@@ -7,31 +7,69 @@
 </p>
 <p align="center">
-  One command. Five registries. All your download stats.
+  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>
   <a href="https://www.npmjs.com/package/@mcptoolshop/registry-stats"><img src="https://img.shields.io/npm/v/@mcptoolshop/registry-stats" alt="npm version"></a>
+  <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="https://mcp-tool-shop-org.github.io/registry-stats/">Docs</a> &middot;
+  <a href="#dashboard">Dashboard</a> &middot;
+  <a href="#desktop-app">Desktop App</a> &middot;
   <a href="#install">Install</a> &middot;
   <a href="#cli">CLI</a> &middot;
-  <a href="#config-file">Config</a> &middot;
   <a href="#programmatic-api">API</a> &middot;
   <a href="#rest-api-server">REST Server</a> &middot;
+  <a href="#config-file">Config</a> &middot;
   <a href="#license">License</a>
 </p>
 ---
-यदि आप npm, PyPI, NuGet, VS Code मार्केटप्लेस या डॉकर हब पर कुछ प्रकाशित करते हैं, तो वर्तमान में आपको "इस महीने मुझे कितने डाउनलोड मिले?" यह जानने के लिए पांच अलग-अलग एपीआई की आवश्यकता होती है। यह लाइब्रेरी आपको सभी के लिए एक ही इंटरफ़ेस प्रदान करती है - या तो कमांड-लाइन इंटरफ़ेस (CLI) के रूप में या प्रोग्रामेटिक एपीआई के रूप में।
+आप npm, PyPI, NuGet, VS Code मार्केटप्लेस और डॉकर हब पर सामग्री प्रकाशित करते हैं। वर्तमान में, "मेरे पैकेज कैसा प्रदर्शन कर रहे हैं?" का उत्तर देने का मतलब है कि आपको पांच अलग-अलग साइटों की जांच करनी होगी। **registry-stats** एक संपूर्ण प्लेटफॉर्म है: यह टाइपस्क्रिप्ट इंजन (CLI + API + REST सर्वर), एक लाइव वेब डैशबोर्ड और एक देशी विंडोज डेस्कटॉप ऐप है - और ये सभी एक ही रिपॉजिटरी से उपलब्ध हैं।
+इसमें कोई रनटाइम निर्भरता नहीं है। यह देशी `fetch()` का उपयोग करता है। Node 18+।
+## इसके अंदर क्या है
+| लेयर | यह क्या करता है |
+|-------|-------------|
+| **Engine** | टाइपस्क्रिप्ट लाइब्रेरी + CLI + REST सर्वर। एक ही इंटरफ़ेस के साथ पांच रजिस्ट्री को क्वेरी करें। इसे npm पर `@mcptoolshop/registry-stats` के रूप में प्रकाशित किया गया है। |
+| **Dashboard** | एस्ट्रो-संचालित वेब ऐप। AI चैट सहायक, 6 इंटरैक्टिव चार्ट, स्मार्ट ग्रोथ इंजन और टैब वाली सहायता गाइड। CI द्वारा साप्ताहिक रूप से पुनर्निर्मित। |
+| **Desktop** | WinUI 3 + WebView2 वाला देशी विंडोज ऐप। डैशबोर्ड को ऑफ़लाइन उपलब्ध कराता है और आवश्यकता पड़ने पर लाइव आँकड़े प्राप्त करता है। |
+## डैशबोर्ड
+एक स्व-अपडेट करने वाला आँकड़े डैशबोर्ड [`/dashboard/`](https://mcp-tool-shop-org.github.io/registry-stats/dashboard/) पर उपलब्ध है।
-शून्य निर्भरता। यह मूल `fetch()` का उपयोग करता है। Node 18 या उससे ऊपर।
+- **टैब इंटरफ़ेस** — Home, Analytics, Leaderboard और Help टैब
+- **AI चैट सहायक** — Ollama-संचालित Registry Assistant जिसमें RAG संदर्भ, स्ट्रीमिंग प्रतिक्रियाएँ, मॉडल चयनकर्ता और वार्तालाप स्मृति शामिल है
+- **कार्यकारी सारांश** — हेल्थ स्कोर (0–100), विविधता सूचकांक, साप्ताहिक परिवर्तन, सभी रजिस्ट्री से कुल डाउनलोड
+- **6 इंटरैक्टिव चार्ट** — 30-दिन ट्रेंड (समष्टि / रजिस्ट्री अनुसार / शीर्ष 5 टॉगल), रजिस्ट्री शेयर (पोलर एरिया), पोर्टफोलियो जोखिम (वितरण हिस्टोग्राम + Gini & P90), शीर्ष 10 मोमेंटम, स्पार्कलाइन युक्त वेलोसिटी ट्रैकर, और 30-दिन हीटमैप (स्पाइक डिटेक्शन >2σ)
+- **स्मार्ट ग्रोथ इंजन** — कम विभाजक विकृति को संभालता है। बेसलाइन थ्रेशोल्ड, प्रतिशत सीमा और अवमंदित वेग सूत्र
+- **कार्ययोग्य अंतर्दृष्टि** — स्वचालित सिफारिशें और गिरावट वाले पैकेजों के लिए चेतावनी
+- **लीडरबोर्ड** — सभी पैकेज साप्ताहिक डाउनलोड के अनुसार रैंक किए गए, 30-दिन स्पार्कलाइन और स्मार्ट ट्रेंड बैज के साथ
+- **सेटअप पेज** — पोर्टफोलियो संपादक, सत्यापन, registry-sync सहयोगी अनुभाग, और पाइपलाइन अवलोकन
+- **सहायता टैब** — प्रत्येक टैब, मुख्य अवधारणाएँ, AI सहायक सुझाव, डेटा पाइपलाइन, और उपयोगी लिंक को कवर करने वाली सरल गाइड
+- **डार्क / लाइट थीम** — सिस्टम वरीयता का पालन करता है।
+डेटा निर्माण के समय प्राप्त किया जाता है और CI (सोमवार सुबह 6:00 UTC) द्वारा साप्ताहिक रूप से पुनर्निर्मित किया जाता है। ट्रैक किए गए पैकेजों को `site/src/data/packages.json` में कॉन्फ़िगर करें।
+## डेस्कटॉप ऐप
+एक देशी विंडोज ऐप जो डैशबोर्ड को एक स्थानीय WebView2 शेल में लपेटता है:
+- **ऑफ़लाइन उपयोग** — बंडल किए गए HTML/CSS/JS के साथ आता है; इंटरनेट के बिना काम करता है।
+- **लाइव रिफ्रेश** — GitHub Pages से `stats.json` प्राप्त करता है।
+- **CSV निर्यात** — लीडरबोर्ड डेटा को एक क्लिक में निर्यात करें।
+- **MSIX पैकेज्ड** — CI के माध्यम से `desktop-ci.yml` का उपयोग करके बनाया और हस्ताक्षरित।
+डेस्कटॉप का स्रोत `desktop/` में है। .NET 10 MAUI के साथ बनाया गया है, जो WinUI 3 को लक्षित करता है।
 ## इंस्टॉल करें
@@ -52,10 +90,6 @@ registry-stats express
 # Time series with monthly breakdown + trend
 registry-stats express -r npm --range 2025-01-01:2025-06-30
-#  2025-01  142,359,021
-#  2025-02  147,522,528
-#  ...
-#  Total: 448,383,383  Avg/day: 4,982,038  Trend: flat (-0.46%)
 # Raw JSON output
 registry-stats express -r npm --json
@@ -74,14 +108,6 @@ registry-stats
 # Compare across registries
 registry-stats express --compare
-#  express — comparison
-#
-#  Metric        npm         pypi
-#  ─────────────────────────────────
-#  Total         -           -
-#  Month         283,472     47,201
-#  Week          67,367      11,800
-#  Day           11,566      1,686
 # Export as CSV or chart-friendly JSON
 registry-stats express -r npm --range 2025-01-01:2025-06-30 --format csv
@@ -161,7 +187,6 @@ calc.toChartData(daily, 'express');        // { labels: [...], datasets: [{ labe
 // Comparison — same package across registries
 const comparison = await stats.compare('express');
-// → { package: 'express', registries: { npm: {...}, pypi: {...} }, fetchedAt: '...' }
 await stats.compare('express', ['npm', 'pypi']);  // specific registries only
 // Caching (5 min TTL, in-memory)
@@ -173,7 +198,7 @@ await stats('npm', 'express', { cache });  // cache hit
 ## रजिस्ट्री समर्थन
 | रजिस्ट्री | पैकेज प्रारूप | समय श्रृंखला | उपलब्ध डेटा |
-| ---------- | --------------- | ------------- | ---------------- |
+|----------|---------------|-------------|----------------|
 | `npm` | `express`, `@scope/pkg` | हाँ (549 दिन) | अंतिम दिन, अंतिम सप्ताह, अंतिम महीना |
 | `pypi` | `requests` | हाँ (180 दिन) | अंतिम दिन, अंतिम सप्ताह, अंतिम महीना, कुल |
 | `nuget` | `Newtonsoft.Json` | No | कुल |
@@ -192,7 +217,6 @@ await stats('npm', 'express', { cache });  // cache hit
 इसे एक माइक्रोसर्विस के रूप में चलाएं या इसे अपने सर्वर में एम्बेड करें:
 ```bash
-# CLI
 registry-stats serve --port 3000
 ```
@@ -240,13 +264,53 @@ registerProvider(cargo);
 await stats('cargo', 'serde');
 ```
-## वेबसाइट
+## रिपॉजिटरी संरचना
+```
+registry-stats/
+├── src/        # TypeScript engine (published to npm)
+├── site/       # Astro dashboard + landing page (deployed to GitHub Pages)
+├── desktop/    # WinUI 3 desktop app (.NET 10 MAUI)
+└── test/       # Library tests (vitest)
+```
+## विकास
+```bash
+# Engine
+npm install && npm run build && npm test
+# Dashboard (dev server)
+npm run site:dev
+# Dashboard (production build)
+npm run site:build
+```
+## सुरक्षा और डेटा दायरा
+| पहलू | विवरण |
+|--------|--------|
+| **Data touched** | npm, PyPI, NuGet, VS Code मार्केटप्लेस, डॉकर हब से सार्वजनिक डाउनलोड आँकड़े। इन-मेमोरी कैश (वैकल्पिक)। |
+| **Data NOT touched** | कोई टेलीमेट्री नहीं। कोई एनालिटिक्स नहीं। कोई क्रेडेंशियल स्टोरेज नहीं। कोई उपयोगकर्ता डेटा नहीं। कोई फ़ाइल लेखन नहीं। |
+| **Permissions** | पढ़ें: सार्वजनिक रजिस्ट्री API HTTPS के माध्यम से। लिखें: केवल stdout/stderr। |
+| **Network** | HTTPS सार्वजनिक रजिस्ट्री API पर। वैकल्पिक लोकलहोस्ट REST सर्वर। |
+| **Telemetry** | कोई भी डेटा एकत्र या भेजा नहीं जाता है। |
+भेद्यता रिपोर्टिंग के लिए [SECURITY.md](SECURITY.md) देखें।
+## स्कोरकार्ड
-दस्तावेज़/लैंडिंग पृष्ठ `site/` में स्थित है।
+| श्रेणी | स्कोर |
+|----------|-------|
+| A. सुरक्षा | 10 |
+| B. त्रुटि प्रबंधन | 10 |
+| C. ऑपरेटर दस्तावेज़ | 10 |
+| D. शिपिंग स्वच्छता | 10 |
+| E. पहचान (सॉफ्ट) | 10 |
+| **Overall** | **50/50** |
-- विकास: `npm run site:dev`
-- बिल्ड: `npm run site:build`
-- पूर्वावलोकन: `npm run site:preview`
+> पूर्ण ऑडिट: [SHIP_GATE.md](SHIP_GATE.md) · [SCORECARD.md](SCORECARD.md)
 ## लाइसेंस