claude-git-hooks 2.9.1 → 2.10.0

package/CHANGELOG.md

@@ -5,6 +5,113 @@ 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).
 
+## [2.10.0] - 2026-02-02
+
+### 🏗️ Architecture - Modular CLI Refactoring
+
+**Major refactoring: All CLI commands extracted to `lib/commands/` modules.**
+
+This release implements a **modular, decoupled, reusable** architecture for better maintainability, testability, and extensibility.
+
+### ✨ Added
+
+- **New `lib/commands/` directory** - One file per CLI command
+    - `helpers.js` - Shared CLI utilities (colors, output, platform detection, Entertainment)
+    - `install.js` - Installation logic (dependencies, hooks, templates, config migration)
+    - `hooks.js` - Hook management (enable, disable, status, uninstall)
+    - `analyze-diff.js` - Diff analysis (generate PR metadata from git diff)
+    - `create-pr.js` - PR creation (full Octokit workflow)
+    - `setup-github.js` - Token setup (interactive GitHub configuration)
+    - `presets.js` - Preset management (list, set, show current)
+    - `update.js` - Self-update (check and install latest version)
+    - `migrate-config.js` - Config migration (legacy to v2.8.0 format)
+    - `debug.js` - Debug toggle (enable/disable verbose logging)
+    - `telemetry-cmd.js` - Telemetry commands (show/clear statistics)
+    - `help.js` - Help display (usage information)
+
+### 🔄 Changed
+
+- **`bin/claude-hooks` reduced from 2,300 to 111 lines** - Now a thin CLI router
+    - Only handles argument parsing and command dispatch
+    - All business logic moved to `lib/commands/` modules
+    - Imports and calls appropriate command module based on CLI argument
+
+- **Design philosophy documented** - CLAUDE.md and README.md updated with:
+    - Purpose annotations for each component/layer
+    - Module responsibility descriptions
+    - Architectural decision rationale
+
+### 🎯 Benefits
+
+| Aspect | Before | After |
+|--------|--------|-------|
+| `bin/claude-hooks` size | 2,277 lines | 111 lines |
+| Command modules | 1 (`setup-github.js`) | 13 files |
+| Testability | Hard (monolithic) | Easy (modular) |
+| Finding code | Search entire file | Match filename to command |
+| Adding commands | Edit large file | Create new module |
+
+### 📚 Documentation
+
+- **README.md** - Added Command Modules table with purpose annotations
+- **CLAUDE.md** - Updated directory structure with purpose for each file
+- **README-NPM.md** - Added architecture section
+- **CHANGELOG.md** - This entry
+
+### 🔧 Technical Details
+
+**New module structure:**
+```
+lib/commands/
+├── helpers.js        (389 lines) - Shared utilities
+├── install.js        (691 lines) - Installation
+├── hooks.js          (148 lines) - Hook management
+├── analyze-diff.js   (267 lines) - Diff analysis
+├── create-pr.js      (374 lines) - PR creation
+├── presets.js        (101 lines) - Preset commands
+├── update.js         (67 lines)  - Self-update
+├── migrate-config.js (103 lines) - Config migration
+├── debug.js          (52 lines)  - Debug mode
+├── telemetry-cmd.js  (47 lines)  - Telemetry
+├── help.js           (147 lines) - Help display
+└── setup-github.js   (98 lines)  - GitHub setup
+```
+
+**Key patterns implemented:**
+- **Command Pattern**: Each CLI command is a self-contained module
+- **Thin Controller**: `bin/claude-hooks` only routes, doesn't implement
+- **Separation of Concerns**: UI helpers in `helpers.js`, business logic in specific modules
+
+### 🗑️ Removed
+
+- **Inline command implementations** from `bin/claude-hooks`:
+    - `install()` - moved to `lib/commands/install.js`
+    - `uninstall()` - moved to `lib/commands/hooks.js`
+    - `enable()` / `disable()` - moved to `lib/commands/hooks.js`
+    - `status()` - moved to `lib/commands/hooks.js`
+    - `analyzeDiff()` - moved to `lib/commands/analyze-diff.js`
+    - `createPr()` - moved to `lib/commands/create-pr.js`
+    - `showPresets()` / `setPreset()` / `currentPreset()` - moved to `lib/commands/presets.js`
+    - `update()` - moved to `lib/commands/update.js`
+    - `migrateConfig()` - moved to `lib/commands/migrate-config.js`
+    - `setDebug()` - moved to `lib/commands/debug.js`
+    - `showTelemetry()` / `clearTelemetry()` - moved to `lib/commands/telemetry-cmd.js`
+    - `showHelp()` / `showVersion()` - moved to `lib/commands/help.js`
+    - Helper functions (colors, log, error, success, etc.) - moved to `lib/commands/helpers.js`
+    - `Entertainment` class - moved to `lib/commands/helpers.js`
+
+### 📋 Migration
+
+**No breaking changes.** All CLI commands work identically. This is an internal refactoring.
+
+```bash
+# All commands work the same
+claude-hooks install
+claude-hooks create-pr develop
+claude-hooks --set-preset backend
+claude-hooks status
+```
+
 ## [2.9.1] - 2025-12-30
 
 ### 🐛 Fixed