claude-git-hooks 1.0.0 → 1.1.0

package/README.md

@@ -49,10 +49,47 @@ git config --global credential.helper store
 # O configura tu credential helper específico
 ```
 
-## 🚀 Instalación Rápida (WSL)
+## 🚀 Instalación
+
+### Opción 1: Paquete NPM Global (Recomendado)
 
 **IMPORTANTE**: Claude CLI corre en WSL, por lo que toda la instalación y uso de git debe hacerse desde la terminal WSL.
 
+#### Instalación Global
+
+```bash
+# Instalar el paquete globalmente
+sudo npm install -g claude-git-hooks
+
+# En cualquier repositorio, instalar los hooks
+cd tu-proyecto
+claude-hooks install
+```
+
+#### Añadir como Dependencia de Desarrollo
+
+```bash
+# Instalar como devDependency
+npm install --save-dev claude-git-hooks
+
+# Añadir script al package.json
+```
+
+Luego añade esto a tu `package.json`:
+
+```json
+{
+  "scripts": {
+    "postinstall": "claude-hooks install"
+  },
+  "devDependencies": {
+    "claude-git-hooks": "^1.0.0"
+  }
+}
+```
+
+### Opción 2: Instalación Local con Scripts
+
 ```bash
 # Desde WSL - Instalación completa
 ./git-hooks/setup-wsl.sh
@@ -70,14 +107,15 @@ git config --global credential.helper store
 ./git-hooks/setup-wsl.sh --disable-hooks prepare-commit-msg  # Deshabilita solo prepare-commit-msg
 ```
 
+## 🤖 Características
+
 **✨ Auto-actualización incorporada**: Los hooks se actualizan automáticamente en cada commit.
 
-**🤖 Hooks instalados**:
+**Hooks disponibles**:
 
 - `pre-commit`: Análisis de código con Claude (solo archivos Java/config)
 - `prepare-commit-msg`: Generación automática de mensajes de commit
 
-
 ## 🎯 Funcionamiento
 
 ### Hook pre-commit (Análisis de código)
@@ -105,10 +143,7 @@ git config --global credential.helper store
 ### Hook prepare-commit-msg (Generación automática de mensajes)
 
 1. **Se activa cuando el mensaje es**:
-   - Vacío (`""`)
    - `"auto"`
-   - `"--"`
-   - `"tmp"`
 2. **Analiza los cambios del staging area**:
    - Lista archivos modificados con estadísticas
    - Incluye diffs completos para archivos < 100KB
@@ -151,48 +186,54 @@ Claude analizará los cambios y generará un mensaje de commit siguiendo las con
 
 **⚠️ Si la generación automática falla**: El commit se cancelará completamente. Simplemente ejecuta `git commit -m "tu mensaje"` manualmente.
 
-### Selección de formato de análisis 📊
+### Modos de análisis 📊
 
-**Opción 1: Con variable de entorno (recomendado)**
+Puedes elegir entre dos formatos de análisis:
+
+#### 🎯 Configurar Modo (Recomendado)
 
 ```bash
-# Para formato estándar
-export CLAUDE_ANALYSIS_MODE=standard
-git commit -m "mensaje"
+# Cambiar a modo SonarQube (métricas y quality gate)
+claude-hooks set-mode sonar
 
-# Para formato SonarQube
-export CLAUDE_ANALYSIS_MODE=sonar
-git commit -m "mensaje"
+# Cambiar a modo estándar (score y recomendaciones)
+claude-hooks set-mode standard
+
+# Ver modo actual
+claude-hooks status
 ```
 
-**Opción 2: Configuración interactiva**
+#### 🔧 Variable de Entorno (Temporal)
 
 ```bash
+# Sobrescribir temporalmente el modo configurado
+export CLAUDE_ANALYSIS_MODE=sonar
 git commit -m "mensaje"
-# En la primera ejecución te preguntará:
-# 1) Estándar - Formato clásico con recomendaciones
-# 2) SonarQube - Formato similar a SonarQube con métricas
+
+# Volver al modo configurado
+unset CLAUDE_ANALYSIS_MODE
 ```
 
-**⚠️ Nota sobre compatibilidad**: La selección interactiva requiere una terminal con soporte TTY (terminal interactiva). En WSL generalmente funciona correctamente. Sin embargo, en algunos entornos como:
+#### 📋 Diferencias entre Modos
 
-- Scripts automatizados
-- CI/CD pipelines
-- Algunos emuladores de terminal
-- Cuando no hay TTY disponible
+**Modo Estándar**:
+- Análisis con puntuación del 1-10
+- Recomendaciones detalladas por categoría
+- Formato tradicional fácil de leer
 
-El sistema automáticamente usará el modo **estándar** como fallback sin preguntar.
+**Modo SonarQube**:
+- Quality Gate (PASSED/FAILED)
+- Métricas: Reliability, Security, Maintainability
+- Issues clasificados por severidad (Blocker, Critical, Major, Minor, Info)
+- Security hotspots
 
-**Opción 3: Cambiar configuración guardada**
+#### 🔄 Cambio de Modo Interactivo
 
 ```bash
-.git/hooks/pre-commit --change-mode
+# Sin parámetros muestra ayuda interactiva
+claude-hooks set-mode
 ```
 
-**Formato Estándar**: Análisis tradicional con score, recomendaciones y detalles por categoría.
-
-**Formato SonarQube**: Análisis con Quality Gate, métricas (Reliability, Security, Maintainability), clasificación de issues por severidad (Blocker, Critical, Major, Minor, Info), y security hotspots.
-
 ### Saltar la revisión (usar con precaución)
 
 ```bash
@@ -221,18 +262,21 @@ Claude responde con un JSON que incluye:
 
 ```bash
 # Desactivar todos los hooks
-./git-hooks/setup-wsl.sh --disable-hooks
+claude-hooks disable
 
 # Desactivar un hook específico
-./git-hooks/setup-wsl.sh --disable-hooks pre-commit
-./git-hooks/setup-wsl.sh --disable-hooks prepare-commit-msg
+claude-hooks disable pre-commit
+claude-hooks disable prepare-commit-msg
 
 # Habilitar todos los hooks
-./git-hooks/setup-wsl.sh --enable-hooks
+claude-hooks enable
 
 # Habilitar un hook específico
-./git-hooks/setup-wsl.sh --enable-hooks pre-commit
-./git-hooks/setup-wsl.sh --enable-hooks prepare-commit-msg
+claude-hooks enable pre-commit
+claude-hooks enable prepare-commit-msg
+
+# Ver estado actual
+claude-hooks status
 ```
 
 ## ⚙️ Configuración
@@ -353,3 +397,155 @@ WSL Terminal
 2. **Line Endings**: La configuración de `core.autocrlf` es crítica para evitar problemas entre Windows y Linux
 3. **Credenciales**: Necesitarás reconfigurar tus credenciales git en WSL
 4. **Performance**: La revisión puede tardar unos segundos dependiendo del tamaño de los cambios
+
+## 🔧 Desarrollo y Contribución
+
+### Estructura del Proyecto
+
+```
+claude-git-hooks/
+├── bin/
+│   └── claude-hooks           # CLI principal
+├── templates/
+│   ├── pre-commit            # Hook de análisis de código
+│   ├── prepare-commit-msg    # Hook de generación de mensajes
+│   ├── CLAUDE_PRE_COMMIT.md  # Pautas estándar
+│   └── CLAUDE_PRE_COMMIT_SONAR.md # Pautas SonarQube
+├── setup-wsl.sh              # Script de instalación local (legacy)
+├── package.json              # Configuración NPM
+├── README.md                 # Este archivo
+├── README-NPM.md             # Documentación para NPM
+└── PUBLISH.md                # Guía de publicación
+```
+
+### Configuración del Entorno de Desarrollo
+
+```bash
+# 1. Clonar el repositorio
+git clone https://github.com/pablorovito/claude-git-hooks.git
+cd claude-git-hooks
+
+# 2. Instalar dependencias (si las hubiera)
+npm install
+
+# 3. Enlazar para desarrollo local
+npm link
+
+# 4. Probar en un repositorio de prueba
+cd /path/to/test-repo
+claude-hooks install
+```
+
+### Workflow de Desarrollo
+
+#### 1. Modificar Hooks
+
+Los hooks están en `templates/`:
+
+- `templates/pre-commit` - Lógica de análisis de código
+- `templates/prepare-commit-msg` - Lógica de generación de mensajes
+
+#### 2. Probar Localmente
+
+```bash
+# Después de modificar archivos
+npm link
+
+# En un repo de prueba
+claude-hooks install --force  # Fuerza reinstalación
+
+# Probar funcionalidad
+git add .
+git commit -m "auto"  # Probar generación automática
+git commit -m "test"  # Probar análisis
+```
+
+#### 3. Actualizar Documentación
+
+- `README.md` - Documentación principal
+- `README-NPM.md` - Para usuarios de NPM
+- `templates/CLAUDE_PRE_COMMIT*.md` - Pautas de evaluación
+
+#### 4. Versioning y Publicación
+
+```bash
+# Actualizar versión
+npm version patch  # 1.0.0 -> 1.0.1
+npm version minor  # 1.0.0 -> 1.1.0
+npm version major  # 1.0.0 -> 2.0.0
+
+# Publicar nueva versión
+npm publish
+
+# Tag en git
+git push --tags
+```
+
+### Debugging
+
+#### Modo Debug
+
+```bash
+# Activar debug en hooks
+DEBUG=1 git commit -m "test"
+
+# Ver logs del CLI
+claude-hooks install --debug
+```
+
+#### Logs Útiles
+
+- `debug-claude-response.json` - Respuestas de Claude en modo debug
+- `~/.npm/_logs/` - Logs de npm install
+- `.git/hooks/` - Verificar que hooks están instalados
+
+### Testing
+
+#### Test Manual
+
+```bash
+# 1. Crear repo de prueba
+mkdir test-repo && cd test-repo
+git init
+
+# 2. Instalar hooks
+claude-hooks install
+
+# 3. Crear archivos de prueba
+echo 'public class Test {}' > Test.java
+git add .
+
+# 4. Probar análisis
+git commit -m "test: nueva clase"
+
+# 5. Probar generación automática
+echo 'public void newMethod() {}' >> Test.java
+git add .
+git commit -m "auto"
+```
+
+#### Casos de Prueba
+
+- ✅ Análisis de código Java
+- ✅ Generación automática de mensajes
+- ✅ Modo SonarQube
+- ✅ Archivos grandes (>100KB)
+- ✅ Commits sin archivos Java
+- ✅ Enable/disable hooks
+- ✅ Modo debug
+
+### Contribuir
+
+1. **Fork** el repositorio
+2. **Crear branch** para tu feature: `git checkout -b feature/nueva-funcionalidad`
+3. **Commit** tus cambios: `git commit -m "feat: nueva funcionalidad"`
+4. **Push** al branch: `git push origin feature/nueva-funcionalidad`
+5. **Abrir Pull Request**
+
+### Roadmap
+
+- [ ] Soporte para más lenguajes (Python, JavaScript, etc.)
+- [ ] Configuración más granular por proyecto
+- [ ] Integration con IDEs populares
+- [ ] Métricas de uso y performance
+- [ ] Tests automatizados

package/bin/claude-hooks

@@ -224,6 +224,18 @@ function status() {
     }
   });
 
+  // Verificar modo de análisis actual
+  console.log('\nModo de análisis:');
+  const analysisMode = fs.existsSync('.claude-analysis-mode') 
+    ? fs.readFileSync('.claude-analysis-mode', 'utf8').trim()
+    : 'standard (por defecto)';
+  
+  if (analysisMode === 'sonar') {
+    info(`Modo actual: SonarQube`);
+  } else {
+    info(`Modo actual: Estándar`);
+  }
+
   // Verificar archivos de pautas
   console.log('\nArchivos de pautas:');
   const guidelines = ['CLAUDE_PRE_COMMIT.md', 'CLAUDE_PRE_COMMIT_SONAR.md'];
@@ -236,6 +248,40 @@ function status() {
   });
 }
 
+// Comando set-mode
+function setMode(mode) {
+  if (!checkGitRepo()) {
+    error('No estás en un repositorio Git.');
+  }
+
+  const validModes = ['standard', 'sonar'];
+  
+  if (!mode) {
+    // Modo interactivo
+    console.log('\nSelecciona el modo de análisis:');
+    console.log('1) Standard - Formato clásico con score y recomendaciones');
+    console.log('2) SonarQube - Formato similar a SonarQube con métricas');
+    console.log('\nEjemplo de uso: claude-hooks set-mode standard');
+    console.log('                claude-hooks set-mode sonar');
+    return;
+  }
+
+  if (!validModes.includes(mode)) {
+    error(`Modo inválido: ${mode}. Usa 'standard' o 'sonar'`);
+  }
+
+  // Guardar el modo
+  fs.writeFileSync('.claude-analysis-mode', mode);
+  
+  if (mode === 'sonar') {
+    success('Modo cambiado a: SonarQube');
+    info('Los commits usarán formato SonarQube con métricas y quality gate');
+  } else {
+    success('Modo cambiado a: Estándar');
+    info('Los commits usarán formato clásico con score y recomendaciones');
+  }
+}
+
 // Comando help
 function showHelp() {
   console.log(`
@@ -248,6 +294,7 @@ Comandos:
   uninstall            Desinstala los hooks del repositorio
   enable [hook]        Habilita hooks (todos o uno específico)
   disable [hook]       Deshabilita hooks (todos o uno específico)
+  set-mode [standard|sonar]  Cambia el modo de análisis
   status               Muestra el estado de los hooks
   help                 Muestra esta ayuda
 
@@ -257,11 +304,13 @@ Hooks disponibles:
 
 Ejemplos:
   claude-hooks install              # Instala todos los hooks
+  claude-hooks set-mode sonar       # Cambiar a modo SonarQube
+  claude-hooks set-mode standard    # Cambiar a modo estándar
   claude-hooks disable pre-commit   # Deshabilita solo pre-commit
   claude-hooks enable               # Habilita todos los hooks
   claude-hooks status               # Ver estado actual
 
-Más información: https://github.com/tresmares/claude-git-hooks
+Más información: https://github.com/pablorovito/claude-git-hooks
 `);
 }
 
@@ -282,6 +331,9 @@ switch (command) {
   case 'disable':
     disable(args[1]);
     break;
+  case 'set-mode':
+    setMode(args[1]);
+    break;
   case 'status':
     status();
     break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-git-hooks",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Git hooks con Claude CLI para análisis de código y generación automática de mensajes de commit",
   "main": "lib/index.js",
   "bin": {