claude-git-hooks 2.16.0 → 2.17.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.17.0] - 2026-02-16
+
+### ✨ Added
+- Automatic GitHub token setup now runs after installation
+
+### 🔧 Changed
+- Simplified CLI help output to show concise command reference instead of verbose documentation
+- Commands in help output are now listed in alphabetical order for easier navigation
+- Installation success message now shows single help reference instead of detailed usage examples
+
+### 🗑️ Removed
+- Removed extensive inline documentation from help output (use README for detailed docs)
+
+
 ## [2.16.0] - 2026-02-15
 
 ### ✨ Added

package/README.md

@@ -243,8 +243,11 @@ claude-hooks --help   # Full command reference
 | `helpers.js` | **Shared CLI utilities** - colors, output, platform detection | `colors`, `error()`, `success()`, `info()`, `checkGitRepo()`, `Entertainment` |
 | `install.js` | **Installation logic** - dependencies, hooks, templates | `runInstall()`, `extractLegacySettings()` |
 | `hooks.js` | **Hook management** - enable, disable, status, uninstall | `runEnable()`, `runDisable()`, `runStatus()`, `runUninstall()` |
+| `analyze.js` | **Interactive code analysis** - analyze before committing | `runAnalyze()` |
 | `analyze-diff.js` | **Diff analysis** - generate PR metadata from git diff | `runAnalyzeDiff()` |
 | `create-pr.js` | **PR creation** - full workflow via Octokit | `runCreatePr()` |
+| `bump-version.js` | **Version management** - bump with CHANGELOG and Git tag | `runBumpVersion()` |
+| `generate-changelog.js` | **CHANGELOG generation** - standalone command | `runGenerateChangelog()` |
 | `setup-github.js` | **Token setup** - interactive GitHub configuration | `runSetupGitHub()` |
 | `presets.js` | **Preset management** - list, set, show current | `runShowPresets()`, `runSetPreset()`, `runCurrentPreset()` |
 | `update.js` | **Self-update** - check and install latest version | `runUpdate()` |

package/lib/commands/help.js

@@ -24,176 +24,40 @@ Claude Git Hooks - Code analysis and automatic messages with Claude CLI
 Usage: claude-hooks <command> [options]
 
 Commands:
-  install [options]    Install hooks in the current repository
-    --force           Reinstall even if they already exist
-    --skip-auth       Skip Claude authentication verification
-  update               Update to the latest available version
-  uninstall            Uninstall hooks from the repository
-  enable [hook]        Enable hooks (all or one specific)
-  disable [hook]       Disable hooks (all or one specific)
-  status               Show the status of hooks
-  analyze-diff [base]  Analyze differences between branches and generate PR info
-  create-pr [base]     Create pull request with auto-generated metadata and reviewers
-  bump-version <type>  Bump version with automatic CHANGELOG and Git tag
-    major             Bump major version (1.0.0 → 2.0.0)
-    minor             Bump minor version (1.0.0 → 1.1.0)
-    patch             Bump patch version (1.0.0 → 1.0.1)
-    --suffix <value>  Add version suffix (e.g., SNAPSHOT, RC)
-    --update-changelog [branch]  Generate CHANGELOG entry (default: main)
-    --dry-run         Preview changes without applying
-    --no-tag          Skip Git tag creation
-    --no-push         Create tag but don't push to remote
-  generate-changelog [version]  Generate CHANGELOG entry independently
-    --base-branch <branch>  Compare against branch (default: main)
-    --release         Mark as released (no [Unreleased] header)
-  setup-github         Setup GitHub login (required for create-pr)
-  presets              List all available presets
-  --set-preset <name>  Set the active preset
-  preset current       Show the current active preset
-  telemetry [action]   Telemetry management (show or clear)
-  --debug <value>      Set debug mode (true, false, or status)
-  --version, -v        Show the current version
-  help                 Show this help
-
-Available hooks:
-  pre-commit           Code analysis before commit
-  prepare-commit-msg   Automatic message generation
-
-Examples:
-  claude-hooks install              # Install all hooks
-  claude-hooks install --skip-auth  # Install without verifying authentication
-  claude-hooks update               # Update to the latest version
-  claude-hooks disable pre-commit   # Disable only pre-commit
-  claude-hooks enable               # Enable all hooks
-  claude-hooks status               # View current status
-  claude-hooks analyze-diff main    # Analyze differences with main
-  claude-hooks setup-github         # Configure GitHub token for PR creation
-  claude-hooks create-pr develop    # Create PR targeting develop branch
-  claude-hooks bump-version minor   # Bump minor version with tag
-  claude-hooks bump-version patch --suffix SNAPSHOT  # Add SNAPSHOT version
-  claude-hooks bump-version major --update-changelog # Bump and update CHANGELOG
-  claude-hooks generate-changelog   # Generate CHANGELOG for current version
-  claude-hooks generate-changelog 2.7.0 --release  # Generate for specific release
-  claude-hooks presets              # List available presets
-  claude-hooks --set-preset backend # Set backend preset
-  claude-hooks preset current       # Show current preset
-  claude-hooks telemetry show       # Show telemetry statistics
-  claude-hooks telemetry clear      # Clear telemetry data
-  claude-hooks --debug true         # Enable debug mode
-  claude-hooks --debug status       # Check debug status
-
-Commit use cases:
-  git commit -m "message"           # Manual message + blocking analysis
-  git commit -m "auto"              # Automatic message + blocking analysis
-  git commit --no-verify -m "auto"  # Automatic message without analysis
-  git commit --no-verify -m "msg"   # Manual message without analysis
-
-Analyze-diff use case:
-  claude-hooks analyze-diff main    # Analyze changes vs main and generate:
-    → PR Title: "feat: add user authentication module"
-    → PR Description: "## Summary\n- Added JWT authentication..."
-    → Suggested branch: "feature/user-authentication"
-
-Create-pr use case (v2.5.0+):
-  claude-hooks create-pr develop    # Create PR targeting develop:
-    → Validates GitHub token
-    → Extracts task-id from branch (IX-123, #456, LIN-123)
-    → Checks version alignment (package.json, pom.xml, CHANGELOG, tags)
-    → Detects and prompts to push unpushed tags
-    → Analyzes diff and generates PR metadata with Claude
-    → Creates PR directly via GitHub API (Octokit)
-    → Adds labels based on preset
-    → Returns PR URL
-
-  Token configuration:
-    → .claude/settings.local.json (recommended, gitignored)
-    → GITHUB_TOKEN environment variable
-    → Claude Desktop config (auto-detected)
-
-Bump-version use case (v2.12.0+):
-  claude-hooks bump-version patch --update-changelog
-    → Validates prerequisites (clean working dir, valid branch, remote)
-    → Detects project type (Node.js, Maven, or both)
-    → Increments version (major/minor/patch)
-    → Updates package.json and/or pom.xml
-    → Generates CHANGELOG entry with Claude (if --update-changelog)
-    → Creates annotated Git tag (v2.7.0)
-    → Pushes tag to remote
-
-  Version workflow examples:
-    2.7.0 → 2.8.0-SNAPSHOT  # Start development
-    2.8.0-SNAPSHOT → 2.8.0-RC  # Release candidate
-    2.8.0-RC → 2.8.0  # Final release
-
-  Integration with create-pr:
-    → Automatically detects version misalignment
-    → Prompts to push unpushed tags before PR creation
-    → Warns if local version <= remote version
-
-Generate-changelog use case (v2.12.0+):
-  claude-hooks generate-changelog [version]
-    → Standalone CHANGELOG generation (no version bump)
-    → Auto-detects version from package.json or pom.xml
-    → Analyzes commits since last tag using Claude
-    → Updates CHANGELOG.md with categorized entries
-    → Useful when bump-version CHANGELOG step fails
-    → Can mark as released or unreleased
-
-  Examples:
-    claude-hooks generate-changelog  # Use current version
-    claude-hooks generate-changelog 2.7.0 --release  # Specific release
-    claude-hooks generate-changelog --base-branch develop  # Compare vs develop
-
-Presets (v2.3.0+):
-  Built-in tech-stack specific configurations:
-  - backend: Spring Boot + SQL Server (.java, .xml, .yml)
-  - frontend: React + Material-UI (.js, .jsx, .ts, .tsx, .css)
-  - fullstack: Backend + Frontend with API consistency checks
-  - database: SQL Server migrations and procedures (.sql)
-  - ai: Node.js + Claude CLI integration (.js, .json, .md)
-  - default: General-purpose mixed languages
-
-Configuration (v2.2.0+):
-  Create .claude/config.json in your project to customize:
-  - Preset selection
-  - Analysis settings (maxFileSize, maxFiles, timeout)
-  - Commit message generation (autoKeyword, timeout)
-  - Parallel execution (enabled, model, batchSize)
-  - Template paths and output files
-  - Debug mode
-
-  Example: .claude/config.json
-  {
-    "preset": "backend",
-    "analysis": { "maxFiles": 30, "timeout": 180000 },
-    "subagents": {
-      "enabled": true,      // Enable parallel execution
-      "model": "haiku",     // haiku (fast) | sonnet | opus
-      "batchSize": 2        // Files per batch (1=fastest)
-    },
-    "system": { "debug": true }
-  }
-
-Parallel Analysis (v2.2.0+):
-  When analyzing 3+ files, parallel execution runs multiple Claude CLI
-  processes simultaneously for faster analysis:
-  - batchSize: 1 → Maximum speed (1 file per process)
-  - batchSize: 2 → Balanced (2 files per process)
-  - batchSize: 4+ → Fewer API calls but slower
-  - Speed improvement: up to 4x faster with batchSize: 1
-
-Debug Mode:
-  Enable detailed logging for troubleshooting:
-  - CLI: claude-hooks --debug true
-  - Config: "system": { "debug": true } in .claude/config.json
-  - Check status: claude-hooks --debug status
-
-Customization:
-  Override prompts by copying to .claude/:
-    cp templates/COMMIT_MESSAGE.md .claude/
-    cp templates/ANALYZE_DIFF.md .claude/
-    cp templates/CLAUDE_PRE_COMMIT.md .claude/
-    # Edit as needed - system uses .claude/ version if exists
+  analyze [--unstaged | --all]           Analyze code interactively before committing
+  analyze-diff [base]                    Analyze diff and generate PR metadata
+  bump-version [type] [options]          Bump version with CHANGELOG and Git tag
+    <type>: major | minor | patch        (optional for suffix-only operations)
+    --dry-run                            Preview changes without applying
+    --interactive                        Force file selection menu
+    --no-commit                          Skip automatic commit
+    --no-tag                             Skip Git tag creation
+    --push                               Push tag to remote
+    --remove-suffix                      Remove version suffix (no type required)
+    --set-suffix <value>                 Set/replace version suffix (no type required)
+    --suffix <value>                     Add version suffix (e.g., SNAPSHOT)
+    --update-changelog [branch]          Generate CHANGELOG entry
+  create-pr [base]                       Create PR with auto-generated metadata
+  --debug <true | false | status>        Toggle debug mode
+  disable [hook]                         Disable hooks (all or specific)
+  enable [hook]                          Enable hooks (all or specific)
+  generate-changelog [version]           Generate CHANGELOG entry independently
+    --base-branch <branch>               Compare against branch (default: main)
+    --release                            Mark as released
+  help, --help, -h                       Show this help
+  install [options]                       Install hooks in current repository
+    --force                              Reinstall even if already exist
+    --skip-auth                          Skip Claude authentication check
+  migrate-config                         Migrate legacy config to v2.8.0 format
+  preset current                         Show current active preset
+  presets                                List all available presets
+  --set-preset <name>                    Set the active preset
+  setup-github                           Configure GitHub token for PR creation
+  status                                 Show hook status
+  telemetry [show | clear]               View or clear telemetry data
+  uninstall                              Remove hooks from repository
+  update                                 Update to latest version
+  --version, -v                          Show current version
 
 More information: https://github.com/pablorovito/claude-git-hooks
 `);

package/lib/commands/install.js

@@ -29,6 +29,7 @@ import {
     getLatestVersion,
     Entertainment
 } from './helpers.js';
+import { runSetupGitHub } from './setup-github.js';
 
 /**
  * Function to check version (used by hooks)
@@ -654,34 +655,9 @@ export async function runInstall(args) {
     updateGitignore();
 
     success('Claude Git Hooks installed successfully! 🎉');
-    console.log('\nUsage:');
-    console.log('  git commit -m "auto"     # Generate message automatically');
-    console.log('  git commit -m "message"  # Analyze code before commit');
-    console.log('  git commit --no-verify   # Skip analysis completely');
-    console.log('\n💡 Configuration (v2.8.0):');
-    console.log('  📁 All templates installed in .claude/');
-    console.log('  📝 Edit .claude/config.json (minimal by default)');
-    console.log('  📂 Examples: .claude/config_example/');
-    console.log('  📦 Backups: .claude/config_old/');
-    console.log('  🎯 Presets: backend, frontend, fullstack, database, ai, default');
-    console.log('  🚀 Parallel analysis enabled by default (hardcoded)');
-    console.log('  🐛 Debug mode: claude-hooks --debug true');
-    console.log('\n🔗 GitHub PR Creation (v2.5.0+):');
-    console.log('  claude-hooks setup-github    # Configure GitHub token');
-    console.log('  claude-hooks create-pr main  # Create PR with auto-metadata');
-    console.log('\n📖 Minimal config.json (v2.8.0):');
-    console.log('  {');
-    console.log('    "version": "2.8.0",');
-    console.log('    "preset": "backend"');
-    console.log('  }');
-    console.log('\n📖 With GitHub customization:');
-    console.log('  {');
-    console.log('    "version": "2.8.0",');
-    console.log('    "preset": "backend",');
-    console.log('    "overrides": {');
-    console.log('      "github": { "pr": { "reviewers": ["your-username"] } }');
-    console.log('    }');
-    console.log('  }');
-    console.log('\n🔧 Advanced: see .claude/config_example/config.advanced.example.json');
-    console.log('\nFor more options: claude-hooks --help');
+    console.log('\nRun claude-hooks --help to see all available commands.');
+
+    // Run GitHub token setup
+    console.log('');
+    await runSetupGitHub();
 }

package/package.json

@@ -1,68 +1,68 @@
-{
-    "name": "claude-git-hooks",
-    "version": "2.16.0",
-    "description": "Git hooks with Claude CLI for code analysis and automatic commit messages",
-    "type": "module",
-    "bin": {
-        "claude-hooks": "./bin/claude-hooks"
-    },
-    "scripts": {
-        "test": "npm run test:all",
-        "test:all": "npm run lint && npm run test:smoke && npm run test:unit && npm run test:integration",
-        "test:smoke": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/smoke --maxWorkers=1",
-        "test:unit": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/unit --forceExit",
-        "test:integration": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/integration --maxWorkers=1 --testTimeout=30000 --forceExit",
-        "test:integration:ci": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/integration/ci-safe.test.js --maxWorkers=1 --testTimeout=30000 --forceExit",
-        "test:changed": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/unit --changedSince=main --forceExit",
-        "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
-        "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
-        "lint": "eslint lib/ bin/claude-hooks",
-        "lint:fix": "eslint lib/ bin/claude-hooks --fix",
-        "format": "prettier --write \"lib/**/*.js\" \"bin/**\" \"test/**/*.js\"",
-        "precommit": "npm run lint && npm run test:smoke",
-        "prepublishOnly": "npm run test:all"
-    },
-    "keywords": [
-        "git",
-        "hooks",
-        "claude",
-        "ai",
-        "code-review",
-        "commit-messages",
-        "pre-commit",
-        "automation"
-    ],
-    "author": "Pablo Rovito",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/pablorovito/claude-git-hooks.git"
-    },
-    "engines": {
-        "node": ">=16.9.0"
-    },
-    "engineStrict": false,
-    "os": [
-        "darwin",
-        "linux",
-        "win32"
-    ],
-    "preferGlobal": true,
-    "files": [
-        "bin/",
-        "lib/",
-        "templates/",
-        "README.md",
-        "CHANGELOG.md",
-        "LICENSE"
-    ],
-    "dependencies": {
-        "@octokit/rest": "^21.0.0"
-    },
-    "devDependencies": {
-        "@types/jest": "^29.5.0",
-        "eslint": "^8.57.0",
-        "jest": "^29.7.0",
-        "prettier": "^3.2.0"
-    }
-}
+{
+    "name": "claude-git-hooks",
+    "version": "2.17.0",
+    "description": "Git hooks with Claude CLI for code analysis and automatic commit messages",
+    "type": "module",
+    "bin": {
+        "claude-hooks": "./bin/claude-hooks"
+    },
+    "scripts": {
+        "test": "npm run test:all",
+        "test:all": "npm run lint && npm run test:smoke && npm run test:unit && npm run test:integration",
+        "test:smoke": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/smoke --maxWorkers=1",
+        "test:unit": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/unit --forceExit",
+        "test:integration": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/integration --maxWorkers=1 --testTimeout=30000 --forceExit",
+        "test:integration:ci": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/integration/ci-safe.test.js --maxWorkers=1 --testTimeout=30000 --forceExit",
+        "test:changed": "node --experimental-vm-modules node_modules/jest/bin/jest.js test/unit --changedSince=main --forceExit",
+        "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
+        "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
+        "lint": "eslint lib/ bin/claude-hooks",
+        "lint:fix": "eslint lib/ bin/claude-hooks --fix",
+        "format": "prettier --write \"lib/**/*.js\" \"bin/**\" \"test/**/*.js\"",
+        "precommit": "npm run lint && npm run test:smoke",
+        "prepublishOnly": "npm run test:all"
+    },
+    "keywords": [
+        "git",
+        "hooks",
+        "claude",
+        "ai",
+        "code-review",
+        "commit-messages",
+        "pre-commit",
+        "automation"
+    ],
+    "author": "Pablo Rovito",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/pablorovito/claude-git-hooks.git"
+    },
+    "engines": {
+        "node": ">=16.9.0"
+    },
+    "engineStrict": false,
+    "os": [
+        "darwin",
+        "linux",
+        "win32"
+    ],
+    "preferGlobal": true,
+    "files": [
+        "bin/",
+        "lib/",
+        "templates/",
+        "README.md",
+        "CHANGELOG.md",
+        "LICENSE"
+    ],
+    "dependencies": {
+        "@octokit/rest": "^21.0.0"
+    },
+    "devDependencies": {
+        "@types/jest": "^29.5.0",
+        "eslint": "^8.57.0",
+        "jest": "^29.7.0",
+        "prettier": "^3.2.0"
+    }
+}