claude-git-hooks 1.5.1 → 1.5.3

package/CHANGELOG.md

@@ -5,18 +5,43 @@ Todos los cambios notables en este proyecto se documentarán en este archivo.
 El formato está basado en [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.3] - 2025-09-12
+
+### Fixed
+
+- 🔧 Comando `analyze-diff` ahora siempre compara con ramas origin
+  - Si se especifica rama: compara con `origin/rama-especificada`
+  - Si no se especifica: compara con `origin/rama-actual`
+  - Fallback automático a `origin/develop` y luego `origin/main` si no existe la rama origin
+
+### Changed
+
+- 📝 Documentación mejorada con intro atractiva y características principales
+- ⚠️ Aclaración importante sobre uso exclusivo en WSL/Ubuntu (no PowerShell/CMD)
+- 🔗 Enlaces directos a configuración previa en sección de instalación
+
+## [1.5.2] - 2025-09-11
+
+### Changed
+
+- 🈳 Traducidos todos los logs a inglés
+- 📋 Aclaraciones de uso de analyze-diff en README
+
 ## [1.5.1] - 2025-09-11
 
 ### Added
+
 - 📋 Sección CHEATSHEET en README
 
 ### Fixed
+
 - 🔧 SKIP_ANALYSIS_BLOCK funciona correctamente
 - 📝 Estructura del proyecto en documentación
 
 ## [1.5.0] - 2025-09-10
 
 ### Added
+
 - 🔍 Nuevo comando `claude-hooks analyze-diff [base]` para análisis de diferencias entre ramas
   - Genera título de PR conciso (máx. 72 caracteres)
   - Crea descripción detallada del PR con markdown
@@ -27,15 +52,18 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
   - Guarda resultados en `.claude-pr-analysis.json`
 
 ### Changed
+
 - 🎯 Modo SonarQube ahora es el predeterminado (no hay selección interactiva)
 - ⚡ Eliminada lógica de selección de modo del pre-commit hook
 - 🗑️ Removidas referencias a guardado de preferencias `.claude-analysis-mode`
 
 ### Fixed
+
 - 🐛 Eliminado prompt interactivo incompatible con algunas consolas
 - 🔧 Pre-commit ahora va directo al análisis sin solicitar input del usuario
 
 ### Removed
+
 - 🗑️ Eliminada selección interactiva de modo de análisis
 - 🗑️ Removido comando `set-mode` (ya no es necesario)
 - 🗑️ Eliminada variable de entorno `CLAUDE_ANALYSIS_MODE`
@@ -43,6 +71,7 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 ## [1.4.2] - 2025-09-08
 
 ### Added
+
 - 🚫 Comentario `// SKIP-ANALYSIS` para excluir código del análisis
   - Una línea: excluye la siguiente línea
   - Bloque: código entre dos comentarios `// SKIP_ANALYSIS_BLOCK` es excluido
@@ -51,31 +80,37 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
   - Inyección de dependencias con field injection es aceptable
 
 ### Changed
+
 - 📋 Actualizada documentación con casos de uso de commits clarificados
 - 🎯 Templates de prompts actualizados con reglas de Spring Framework
 
 ### Fixed
+
 - 🔧 Clarificado que `git commit --no-verify -m "auto"` genera mensaje automático sin análisis
 
 ## [1.4.1] - 2025-09-04
 
 ### Changed
+
 - 🚀 **BREAKING**: Eliminado modo estándar, ahora solo existe modo SonarQube
 - ⚡ Prompts optimizados para Claude: reducción de ~80% en tokens manteniendo eficacia
 - 🎯 Nuevo formato ultra-compacto de prompts usando notación concisa y directivas claras
 - 📝 Templates simplificados: CLAUDE_ANALYSIS_PROMPT_SONAR.md, CLAUDE_PRE_COMMIT_SONAR.md, CLAUDE_RESOLUTION_PROMPT.md
 
 ### Fixed
+
 - 🐛 Mejorada la lógica de escritura para mejor formación del prompt de resolución de problemas críticos
 - 🔧 Corregido el formato del prompt AI-friendly para resolución de issues
 
 ### Removed
+
 - 🗑️ Eliminados archivos del modo estándar: CLAUDE_PRE_COMMIT.md, CLAUDE_ANALYSIS_PROMPT.md
 - 🗑️ Eliminada lógica de selección de modo (ahora siempre usa SonarQube)
 
 ## [1.4.0] - 2025-08-29
 
 ### Added
+
 - 🎯 Prompts externalizados en archivos `.md` para facilitar personalización
 - 🤖 Generación automática de prompt AI-friendly para resolución de problemas críticos
 - 📝 Nuevos templates de prompts: `CLAUDE_ANALYSIS_PROMPT.md`, `CLAUDE_ANALYSIS_PROMPT_SONAR.md`, `CLAUDE_RESOLUTION_PROMPT.md`
@@ -85,16 +120,19 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - 📖 Ejemplos detallados de respuestas JSON con blocking issues en README
 
 ### Changed
+
 - 🏗️ Estandarización de `blockingIssues` a formato objeto (nunca strings)
 - 📦 Separación de prompts del código para mayor mantenibilidad
 - 🔧 Hook pre-commit simplificado sin fallbacks complejos
 - 📁 Instalador actualizado para copiar todos los templates de prompts
 
 ### Fixed
+
 - 🐛 Consistencia en el formato de respuesta JSON para ambos modos
 - 🔧 Mejor manejo de errores cuando faltan archivos de configuración
 
 ### Technical
+
 - 🏗️ Función `generate_resolution_prompt()` para crear prompts de resolución
 - 📝 Templates de prompts con placeholders reemplazables
 - 🎯 Estructura JSON estricta para blockingIssues con campos obligatorios
@@ -103,6 +141,7 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 ## [1.3.0] - 2025-08-28
 
 ### Added
+
 - 🚀 Nuevo comando `claude-hooks update` para actualizar a la última versión disponible
 - 🔄 Verificación automática de versión antes de cada commit con prompt interactivo
 - 📜 Script compartido `check-version.sh` para evitar duplicación de código
@@ -110,16 +149,19 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - 📊 Mensajes informativos detallados durante el proceso de verificación y actualización
 
 ### Changed
+
 - 🎯 El hook `pre-commit` ahora verifica automáticamente si hay actualizaciones disponibles
 - 📦 La instalación ahora incluye el script `check-version.sh` en `.git/hooks/`
 - 🔧 Mejorada la UX con mensajes claros sobre el estado de la versión
 
 ### Fixed
+
 - 🐛 Corregido el parsing de versión desde NPM API (usaba endpoint incorrecto)
 - 🔧 Mejorada la compatibilidad del prompt interactivo para consolas IntelliJ/WSL
 - 📝 Múltiples métodos de fallback para leer input del usuario
 
 ### Technical
+
 - 🏗️ Función `getLatestVersion()` ahora usa `dist-tags.latest` de NPM API
 - 🔄 Función `checkVersionAndPromptUpdate()` reutilizable para verificación
 - 📁 Script compartido para evitar duplicación de lógica de verificación
@@ -128,33 +170,39 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 ## [1.2.4] - 2025-08-22
 
 ### Fixed
+
 - 🐛 Corregido el análisis de SonarQube para mostrar correctamente el formato detallado
 - 📊 Arreglado el parsing de JSON para buscar `QUALITY_GATE` en mayúsculas según las pautas
 - 🔧 Actualizado el mapeo de campos JSON para coincidir con la estructura esperada
 
 ### Changed
+
 - 📈 Añadidas métricas de coverage, duplications y complexity al formato SonarQube
 - 📝 Actualizado el archivo de pautas SonarQube para incluir todas las métricas
 
 ## [1.2.3] - 2025-08-22
 
 ### Added
+
 - 🚀 Actualización automática de `.gitignore` durante la instalación
 - 📝 Claude Hooks ahora agrega automáticamente las entradas necesarias a `.gitignore`
 - 🔍 El comando `status` ahora muestra el estado de las entradas en `.gitignore`
 
 ### Changed
+
 - 🎯 Mejorado el proceso de instalación para ser más completo y automatizado
 - 📊 El comando `status` ahora proporciona información más detallada sobre la configuración
 
 ## [1.2.2] - 2025-08-22
 
 ### Fixed
+
 - 🐛 Corregido problema donde los archivos markdown de pautas no se instalaban correctamente desde npm
 - 📁 Los archivos de pautas ahora se instalan en el directorio `.claude/` en lugar de la raíz del proyecto
 - 🔧 Actualizado el hook pre-commit para buscar los archivos de pautas en la nueva ubicación `.claude/`
 
 ### Changed
+
 - 📂 Los archivos `CLAUDE_PRE_COMMIT.md` y `CLAUDE_PRE_COMMIT_SONAR.md` ahora se almacenan en `.claude/`
 - 🎯 Mejorada la organización del proyecto manteniendo los archivos de configuración separados del código fuente
 - 📝 Actualizada la documentación para reflejar la nueva estructura de directorios
@@ -162,6 +210,7 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 ## [1.2.1] - 2024-07-24
 
 ### Fixed
+
 - 🐛 Corregido problema de bloqueo del spinner durante verificación de autenticación Claude
 - 🎨 Arreglado sistema de entretenimiento para mostrar correctamente spinner, chistes y countdown
 - 🔧 Solucionado problema de líneas duplicadas en consola después del segundo chiste
@@ -169,11 +218,13 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - ⏱️ Aumentado timeout de verificación de autenticación a 2 minutos
 
 ### Changed
+
 - 🔄 Reemplazado `execSync` por `spawn` en verificación de autenticación para evitar bloqueos
 - 📍 Mejorado sistema de posicionamiento del cursor para renderizado consistente
 - 🎯 Optimizada lógica de actualización del spinner para evitar race conditions
 
 ### Technical
+
 - 🏗️ Uso de `spawn` con `stdio: 'ignore'` para mantener compatibilidad con comportamiento original
 - 🎮 Sistema de reserva de espacio (3 líneas) para evitar problemas de renderizado
 - 🧮 Contador de chistes cada 10 segundos real (sin drift de tiempo)
@@ -182,6 +233,7 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 ## [1.2.0] - 2024-07-24
 
 ### Added
+
 - ✨ Sistema de entretenimiento con spinner animado y chistes durante operaciones largas
 - 🔐 Lectura segura y no-persistente de contraseña sudo para instalación automática
 - 🛠️ Verificación completa de dependencias del sistema (jq, curl, herramientas Unix)
@@ -190,15 +242,18 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - 🎭 Chistes rotativos cada 10 segundos durante verificación de autenticación Claude
 
 ### Enhanced
+
 - 📦 Función `install` ahora incluye verificación e instalación completa de dependencias
 - 🔍 Verificación de autenticación Claude con entretenimiento visual
 - 💻 Detección inteligente de plataforma (Linux/macOS) para instalación de paquetes
 
 ### Removed
+
 - 🗑️ Eliminados archivos `setup-wsl.sh` y `setup-wsl.js` (redundantes)
 - 🧹 Simplificación de la arquitectura eliminando duplicación de código
 
 ### Technical
+
 - 🔧 Añadido módulo `https` para obtener chistes de API externa
 - 🎨 Clase `Entertainment` para manejo de spinner y chistes
 - 🔐 Funciones `readPassword()` y `testSudoPassword()` para manejo seguro de credenciales
@@ -207,23 +262,27 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 ## [1.1.0] - 2024-07-24
 
 ### Added
+
 - 🎯 Comando `set-mode` para cambiar entre análisis estándar y SonarQube
 - 📊 Modo SonarQube con métricas detalladas y quality gate
 - 📈 Visualización del modo de análisis actual en comando `status`
 - 🔧 Configuración persistente del modo de análisis en archivo `.claude-analysis-mode`
 
-### Enhanced  
+### Enhanced
+
 - 📋 Comando `status` ahora muestra modo de análisis y archivos de pautas
 - 📚 Documentación mejorada con ejemplos de ambos modos
 - 🎨 Mejor formateo de salida en comandos informativos
 
 ### Technical
+
 - 📁 Detección automática de archivos de pautas (CLAUDE_PRE_COMMIT.md, CLAUDE_PRE_COMMIT_SONAR.md)
 - 🏗️ Estructura preparada para múltiples modos de análisis
 
 ## [1.0.0] - 2024-07-24
 
 ### Added
+
 - 🎉 Primera versión estable del paquete npm `claude-git-hooks`
 - 📦 CLI global `claude-hooks` para gestión de hooks de Git
 - 🪝 Instalación automática de hooks `pre-commit` y `prepare-commit-msg`
@@ -235,6 +294,7 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - 🔄 Sistema de backup automático de hooks existentes
 
 ### Technical
+
 - 🏗️ Arquitectura modular con funciones especializadas
 - 🎨 Sistema de colores para output legible
 - 🛡️ Validaciones de entorno (repositorio Git, dependencias)
@@ -243,9 +303,10 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 ---
 
 ## Tipos de cambios
+
 - `Added` - para nuevas funcionalidades
-- `Changed` - para cambios en funcionalidades existentes  
+- `Changed` - para cambios en funcionalidades existentes
 - `Deprecated` - para funcionalidades que serán removidas
 - `Removed` - para funcionalidades removidas
 - `Fixed` - para corrección de bugs
-- `Security` - para vulnerabilidades corregidas
+- `Security` - para vulnerabilidades corregidas

package/README.md

@@ -1,10 +1,15 @@
 # Pre-commit Hook con Claude CLI
 
-Este directorio contiene un pre-commit hook que utiliza Claude CLI para revisar automáticamente el código antes de cada commit.
-Otras funciones de interés:
+🚀 **Transforma tu flujo de desarrollo con IA**: análisis de código instantáneo, mensajes de commit automáticos y generación de PRs perfectas. Claude revisa tu código antes de cada commit, detecta issues críticos al estilo SonarQube, y genera toda la documentación que necesitas. ¿Lo mejor? Se ejecuta localmente sin contaminar tu CI/CD.
 
-- Generación de mensaje de commit.
-- Generación de información de PR y tests de validación de PR - Utiliza análisis de diferencias entre contenido local y origin.
+## 🎯 Características principales
+
+- 🔍 **Análisis de código pre-commit**: Detecta issues críticos antes de que lleguen al repo
+- 💬 **Mensajes de commit automáticos**: Escribe "auto" y Claude genera el mensaje perfecto
+- 📋 **Generación de PRs**: Título, descripción y tests sugeridos con un solo comando
+- 🎨 **Modo SonarQube**: Métricas de calidad y Quality Gate integrados
+- 🚫 **Skip inteligente**: Excluye código legacy con comentarios SKIP-ANALYSIS
+- 🔄 **Auto-actualización**: Se mantiene actualizado automáticamente
 
 ## 📋 CHEATSHEET
 
@@ -14,10 +19,10 @@ Otras funciones de interés:
 # Commit rápido sin análisis + mensaje automático
 git commit --no-verify -m "auto"
 
-# Analizar diferencias con rama origin actual
+# Analizar diferencias con origin de la rama actual
 claude-hooks analyze-diff
 
-# Analizar diferencias para PR (comparar con develop)
+# Analizar diferencias para PR (comparar con origin/develop)
 claude-hooks analyze-diff develop
 
 # Reinstalar durante desarrollo (después de npm link)
@@ -26,8 +31,16 @@ claude-hooks install --force --skip-auth
 
 ### 📦 Instalación y Gestión
 
+⚠️ **IMPORTANTE**: Todo debe ejecutarse desde consola WSL/Ubuntu (no PowerShell ni CMD). Ver [Configuración Previa](#-configuración-previa-importante) antes de comenzar.
+
+Se debe instalar el paquete globalmente, para luego gestionarlo localmente en cada repositorio.
+
 ```bash
-# Instalación inicial
+# En consola WSL/Ubuntu - Instalar globalmente
+npm install -g claude-git-hooks
+
+# Luego en cada proyecto (también desde WSL/Ubuntu)
+cd /tu/proyecto
 claude-hooks install
 
 # Actualizar a última versión
@@ -123,28 +136,7 @@ git commit -m "fix: resolver issues"
 
 ## 🔧 Configuración Previa Importante
 
-### 1. Armonización de Line Endings (EOL) -- Automatizada
-
-Debido a que Claude CLI corre en WSL y el desarrollo puede hacerse en Windows, es crucial configurar correctamente los line endings para evitar que los archivos de hooks se corrompan:
-
-```bash
-# IMPORTANTE: Usar la misma configuración en WSL y Windows
-# Recomendación: usar 'input' en ambos entornos
-
-# En WSL
-git config core.autocrlf input
-
-# En PowerShell/Windows
-git config core.autocrlf input
-
-# Verificar configuración actual
-git config --local core.autocrlf
-git config --global core.autocrlf
-```
-
-**⚠️ ADVERTENCIA**: Si tienes `core.autocrlf = true` en local e `input` en global, esto puede causar que los archivos de los hooks se vacíen. Asegúrate de que ambas configuraciones sean consistentes.
-
-### 2. Credenciales Git en WSL
+### Credenciales Git en WSL
 
 Debes configurar tus credenciales de git nuevamente en WSL:
 
@@ -264,7 +256,7 @@ Si no existe un `.gitignore`, se creará uno nuevo. Si ya existe, las entradas s
 
 ### Características adicionales
 
-- **Generación de información para Pull Requests**: `claude-hooks analyze-diffs {branch}` para comparar rama local con otra rama, propone nombre para rama actual, título y detalles para pull request, da tips para verificar trabajo. Este comando genera automáticamente:
+- **Generación de información para Pull Requests**: `claude-hooks analyze-diff [branch]` para comparar rama local con rama origin, propone nombre para rama actual, título y detalles para pull request, da tips para verificar trabajo. Si se especifica branch, compara con origin/branch. Si no, compara con origin de la rama actual. Este comando genera automáticamente:
   - 📝 Título de PR conciso (máx. 72 caracteres)
   - 📄 Descripción detallada con markdown
   - 🌿 Nombre de rama sugerido (formato: tipo/descripcion)