Merge feature/doctor-health-score: add doctor health score (v1.6.1)

Author: SoftDryzz

README.md

@@ -171,7 +171,8 @@ pm run order-service
 - 🌿 **Git integration** - See branch, status, and unpushed commits in `pm info`
 - 🔧 **Environment variables** - Configure per-project variables (PORT, DEBUG, API_KEY, etc)
 - 🩺 **Runtime checker** - Detects missing runtimes before execution, shows install instructions
-- 🏥 **pm doctor** - Diagnose your environment: verify installed tools and validate project paths
+- 🏥 **pm doctor** - Diagnose your environment: verify installed tools, validate project paths, and get A–F health scores
+- 📊 **Health scores** - Project health grading (A/B/C/D/F) based on best practices (.gitignore, README, tests, CI, lockfile)
 - 🔄 **Auto-update** - Check for updates on startup, update with `pm update`
 - 🔃 **Project refresh** - Re-detect types and update commands with `pm refresh`, warns when projects are outdated
 - ✏️ **Rename & path update** - Rename projects or update paths with `pm rename`, preserving all data
@@ -243,7 +244,8 @@ chmod +x scripts/install.sh && ./scripts/install.sh
 | `pm refresh <name>` | Re-detect project type and update commands |
 | `pm refresh --all` | Refresh all registered projects |
 | `pm update` | Update to the latest version |
-| `pm doctor` | Diagnose environment (runtimes, paths) |
+| `pm doctor` | Diagnose environment (runtimes, paths, health scores) |
+| `pm doctor --score` | Show only health grades (A/B/C/D/F) per project |
 | `pm help` | Show help |
 | `pm version` | Show version |
 
@@ -453,9 +455,9 @@ Projects are saved in:
 - **CLI** — `pm doctor`, `pm env`, `pm refresh`, `pm rename`, `pm update`, `pm commands add/remove`
 - **Runtimes** — Gradle, Maven, Node.js, .NET, Python, Rust, Go, pnpm, Bun, Yarn, Flutter, Docker
 - **Integrations** — Git status, interactive TTY, multi-platform installers, GitHub Actions
-- **Reliability** — Atomic writes, backup/recovery, directory validation, download integrity, 402 tests
+- **Reliability** — Atomic writes, backup/recovery, directory validation, download integrity, 441 tests
 
-> Latest release: **v1.6.0** (Shell Autocompletion) — Full version history in [ROADMAP.md](ROADMAP.md)
+> Latest release: **v1.6.1** (Doctor Health Score) — Full version history in [ROADMAP.md](ROADMAP.md)
 
 ### 💡 Future Ideas
 - [ ] `pm run-all` / `pm build-all` - Execute commands across all projects

ROADMAP.md

@@ -183,14 +183,21 @@ Run custom scripts automatically before or after any command. Hooks are per-proj
 
 ---
 
-## v1.6.1 — Doctor Health Score
+## v1.6.1 — Doctor Health Score ✅
 
 ### `pm doctor` expanded
-- Health score: **A/B/C/D/F** rating based on project best practices
-- Checks: `.gitignore` exists, README present, tests configured, CI detected, dependencies up to date
-- Actionable recommendations per check
-- `pm doctor` — show full health report with score
-- `pm doctor --score` — show only the letter grade
+
+| Feature | Status |
+|---------|--------|
+| Health score: **A/B/C/D/F** rating based on project best practices | ✅ Done |
+| Check: `.gitignore` exists in project root | ✅ Done |
+| Check: README present (case-insensitive) | ✅ Done |
+| Check: Tests configured (`test` command exists) | ✅ Done |
+| Check: CI/CD detected (GitHub Actions, GitLab CI, Jenkins) | ✅ Done |
+| Check: Dependencies lockfile present (per project type) | ✅ Done |
+| Actionable recommendations per failed check | ✅ Done |
+| `pm doctor` — full report with health details per project | ✅ Done |
+| `pm doctor --score` — compact grade-only output | ✅ Done |
 
 ---
 

User-Guide.md

@@ -662,7 +662,32 @@ Run 'pm refresh my-project' to update
 pm doctor
 ```
 
-Verifies installed runtimes (Java, Node.js, .NET, Python, Gradle, Maven, Rust/Cargo, Go, pnpm, Bun, Yarn, Flutter) and validates all registered project paths.
+Verifies installed runtimes (Java, Node.js, .NET, Python, Gradle, Maven, Rust/Cargo, Go, pnpm, Bun, Yarn, Flutter), validates all registered project paths, and shows a **health report** for each project.
+
+#### Health checks performed (per project)
+
+| Check | Pass condition | Recommendation if failed |
+|-------|---------------|--------------------------|
+| `.gitignore` | File exists in project root | Create a .gitignore to exclude build artifacts |
+| README | `README.md` or `README` exists (case-insensitive) | Add a README.md to document your project |
+| Tests | Project has a `test` command configured | Configure tests with `pm commands add` |
+| CI/CD | GitHub Actions, GitLab CI, or Jenkinsfile detected | Set up CI/CD for automated testing |
+| Lockfile | Dependency lockfile exists for project type | Commit your lockfile for reproducible builds |
+
+Each project receives a **letter grade** based on how many checks pass:
+- **A** = 5/5 — **B** = 4/5 — **C** = 3/5 — **D** = 2/5 — **F** = 0–1/5
+
+#### Show only health grades (compact)
+```bash
+pm doctor --score
+```
+
+Shows just the letter grade per project without details:
+```
+  A  backend
+  B  frontend
+  F  legacy-api
+```
 
 ---
 
@@ -1610,7 +1635,8 @@ pm completions fish                            # Generate Fish completion script
 pm completions powershell                      # Generate PowerShell completion script
 
 # === DIAGNOSTICS ===
-pm doctor                                      # Check environment health
+pm doctor                                      # Full report: runtimes + project health (A-F)
+pm doctor --score                              # Compact: only health grades per project
 
 # === UPDATES ===
 pm update                                      # Update to latest version

docs/es/README.md

@@ -171,7 +171,8 @@ pm run servicio-pedidos
 - 🌿 **Integración Git** - Ve branch, status y commits sin pushear en `pm info`
 - 🔧 **Variables de entorno** - Configura variables por proyecto (PORT, DEBUG, API_KEY, etc)
 - 🩺 **Runtime checker** - Detecta runtimes faltantes antes de ejecutar, muestra instrucciones de instalación
-- 🏥 **pm doctor** - Diagnostica tu entorno: verifica herramientas instaladas y valida rutas de proyectos
+- 🏥 **pm doctor** - Diagnostica tu entorno: verifica herramientas instaladas, valida rutas de proyectos y muestra puntuaciones de salud A–F
+- 📊 **Puntuación de salud** - Calificación de salud del proyecto (A/B/C/D/F) basada en buenas prácticas (.gitignore, README, tests, CI, lockfile)
 - 🔄 **Auto-actualización** - Comprueba actualizaciones al arrancar, actualiza con `pm update`
 - 🔃 **Refrescar proyectos** - Re-detecta tipos y actualiza comandos con `pm refresh`, avisa cuando los proyectos están desactualizados
 - ✏️ **Renombrar y actualizar ruta** - Renombra proyectos o actualiza rutas con `pm rename`, preservando todos los datos
@@ -243,7 +244,8 @@ chmod +x scripts/install.sh && ./scripts/install.sh
 | `pm refresh <nombre>` | Re-detectar tipo de proyecto y actualizar comandos |
 | `pm refresh --all` | Refrescar todos los proyectos registrados |
 | `pm update` | Actualizar a la última versión |
-| `pm doctor` | Diagnosticar entorno (runtimes, rutas) |
+| `pm doctor` | Diagnosticar entorno (runtimes, rutas, puntuación de salud) |
+| `pm doctor --score` | Mostrar solo calificaciones de salud (A/B/C/D/F) por proyecto |
 | `pm help` | Mostrar ayuda |
 | `pm version` | Mostrar versión |
 
@@ -453,9 +455,9 @@ Los proyectos se guardan en:
 - **CLI** — `pm doctor`, `pm env`, `pm refresh`, `pm rename`, `pm update`, `pm commands add/remove`
 - **Runtimes** — Gradle, Maven, Node.js, .NET, Python, Rust, Go, pnpm, Bun, Yarn, Flutter, Docker
 - **Integraciones** — Estado Git, TTY interactivo, instaladores multi-plataforma, GitHub Actions
-- **Fiabilidad** — Escritura atómica, backup/recuperación, validación de directorio, integridad de descarga, 402 tests
+- **Fiabilidad** — Escritura atómica, backup/recuperación, validación de directorio, integridad de descarga, 441 tests
 
-> Última release: **v1.6.0** (Autocompletado en Shell) — Historial completo en [ROADMAP.md](ROADMAP.md)
+> Última release: **v1.6.1** (Puntuación de Salud del Doctor) — Historial completo en [ROADMAP.md](ROADMAP.md)
 
 ### 💡 Ideas Futuras
 - [ ] `pm run-all` / `pm build-all` - Ejecutar comandos en todos los proyectos

docs/es/ROADMAP.md

@@ -183,14 +183,21 @@ Ejecuta scripts personalizados automáticamente antes o después de cualquier co
 
 ---
 
-## v1.6.1 — Puntuación de Salud del Doctor
+## v1.6.1 — Puntuación de Salud del Doctor ✅
 
 ### `pm doctor` ampliado
-- Puntuación de salud: calificación **A/B/C/D/F** basada en buenas prácticas del proyecto
-- Verificaciones: `.gitignore` existe, README presente, tests configurados, CI detectado, dependencias actualizadas
-- Recomendaciones accionables por verificación
-- `pm doctor` — mostrar reporte completo con puntuación
-- `pm doctor --score` — mostrar solo la calificación
+
+| Funcionalidad | Estado |
+|---------------|--------|
+| Puntuación de salud: calificación **A/B/C/D/F** basada en buenas prácticas | ✅ Hecho |
+| Verificación: `.gitignore` existe en la raíz del proyecto | ✅ Hecho |
+| Verificación: README presente (sin distinción de mayúsculas) | ✅ Hecho |
+| Verificación: Tests configurados (comando `test` existe) | ✅ Hecho |
+| Verificación: CI/CD detectado (GitHub Actions, GitLab CI, Jenkins) | ✅ Hecho |
+| Verificación: Lockfile de dependencias presente (por tipo de proyecto) | ✅ Hecho |
+| Recomendaciones accionables por verificación fallida | ✅ Hecho |
+| `pm doctor` — reporte completo con detalles de salud por proyecto | ✅ Hecho |
+| `pm doctor --score` — salida compacta solo con calificaciones | ✅ Hecho |
 
 ---
 

docs/es/User-Guide.md

@@ -662,7 +662,32 @@ Run 'pm refresh mi-proyecto' to update
 pm doctor
 ```
 
-Verifica runtimes instalados (Java, Node.js, .NET, Python, Gradle, Maven, Rust/Cargo, Go, pnpm, Bun, Yarn, Flutter) y valida las rutas de todos los proyectos registrados.
+Verifica runtimes instalados (Java, Node.js, .NET, Python, Gradle, Maven, Rust/Cargo, Go, pnpm, Bun, Yarn, Flutter), valida las rutas de todos los proyectos registrados y muestra un **reporte de salud** por cada proyecto.
+
+#### Verificaciones de salud (por proyecto)
+
+| Verificación | Condición para pasar | Recomendación si falla |
+|-------------|---------------------|----------------------|
+| `.gitignore` | El archivo existe en la raíz del proyecto | Crea un .gitignore para excluir artefactos de build |
+| README | `README.md` o `README` existe (sin distinción de mayúsculas) | Añade un README.md para documentar tu proyecto |
+| Tests | El proyecto tiene un comando `test` configurado | Configura tests con `pm commands add` |
+| CI/CD | GitHub Actions, GitLab CI o Jenkinsfile detectado | Configura CI/CD para testing automatizado |
+| Lockfile | Lockfile de dependencias existe para el tipo de proyecto | Commitea tu lockfile para builds reproducibles |
+
+Cada proyecto recibe una **calificación** basada en cuántas verificaciones pasa:
+- **A** = 5/5 — **B** = 4/5 — **C** = 3/5 — **D** = 2/5 — **F** = 0–1/5
+
+#### Mostrar solo calificaciones (compacto)
+```bash
+pm doctor --score
+```
+
+Muestra solo la nota por proyecto sin detalles:
+```
+  A  backend
+  B  frontend
+  F  legacy-api
+```
 
 ---
 
@@ -1610,7 +1635,8 @@ pm completions fish                                # Generar script para Fish
 pm completions powershell                          # Generar script para PowerShell
 
 # === DIAGNÓSTICOS ===
-pm doctor                                          # Verificar salud del entorno
+pm doctor                                          # Reporte completo: runtimes + salud (A-F)
+pm doctor --score                                  # Compacto: solo calificaciones por proyecto
 
 # === ACTUALIZACIONES ===
 pm update                                          # Actualizar a última versión

pom.xml

@@ -8,7 +8,7 @@
     <!-- Identificación del proyecto -->
     <groupId>pm</groupId>
     <artifactId>projectmanager</artifactId>
-    <version>1.6.0</version>
+    <version>1.6.1</version>
     <packaging>jar</packaging>
 
     <name>ProjectManager</name>

scripts/install.ps1

@@ -1,7 +1,7 @@
 # ProjectManager - Installation Script for Windows
 # Works both from source (mvn clean package) and from GitHub Release download
 
-$jarName = "projectmanager-1.6.0.jar"
+$jarName = "projectmanager-1.6.1.jar"
 
 Write-Host "=== ProjectManager Installer ===" -ForegroundColor Cyan
 Write-Host ""

scripts/install.sh

@@ -2,7 +2,7 @@
 # ProjectManager - Installation Script for Linux/Mac
 # Works both from source (mvn clean package) and from GitHub Release download
 
-JAR_NAME="projectmanager-1.6.0.jar"
+JAR_NAME="projectmanager-1.6.1.jar"
 
 echo "=== ProjectManager Installer ==="
 echo ""