claude-git-hooks 2.10.0 → 2.12.0

package/CHANGELOG.md

@@ -5,6 +5,91 @@ 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.12.0] - 2026-02-03
+
+### ✨ Added
+
+- **Automatic version management with `bump-version` command**
+    - Detects project type (Node.js, Maven, or monorepo with both)
+    - Increments version following semantic versioning (major/minor/patch)
+    - Supports version suffixes (SNAPSHOT, RC, custom)
+    - Updates package.json and/or pom.xml automatically
+    - Generates CHANGELOG entries using Claude AI analysis of commits
+    - Creates annotated Git tags with `v` prefix (v2.7.0, v2.7.0-SNAPSHOT)
+    - Automatically pushes tags to remote
+    - CLI options: `--suffix`, `--update-changelog`, `--dry-run`, `--no-tag`, `--no-push`
+
+- **CHANGELOG generation with Claude integration**
+    - Standalone `generate-changelog` command for independent CHANGELOG generation without version bumping
+    - Support for manual version specification in CHANGELOG generation via command argument
+    - Base branch selection for CHANGELOG comparison via `--base-branch` flag
+    - Release marking option via `--release` flag to control [Unreleased] header behavior
+    - Analyzes commits since last final version tag
+    - Categorizes changes by Conventional Commits types
+    - Generates human-readable entries in Keep a Changelog format
+    - Sections: Added, Changed, Fixed, Security, Deprecated, Removed
+    - Places entries in [Unreleased] for suffixed versions, [X.Y.Z] for final versions
+
+- **Version alignment validation in `create-pr`** (#44)
+    - Checks consistency across package.json, pom.xml, CHANGELOG.md, and git tags
+    - Compares local version vs remote version
+    - Shows helpful prompts with fix commands if misalignment detected
+    - Allows user to continue or abort PR creation based on validation results
+
+- **Unpushed tags detection in `create-pr`** (#44)
+    - Detects local tags not pushed to remote
+    - Prompts user to push tags before creating PR
+    - Prevents version inconsistencies between local and remote
+
+- **New utility modules**:
+    - `lib/utils/version-manager.js` - Version detection, parsing, incrementing, validation
+    - `lib/utils/git-tag-manager.js` - Git tag operations (create, list, compare, push)
+    - `lib/utils/changelog-generator.js` - CHANGELOG generation with Claude
+    - `templates/GENERATE_CHANGELOG.md` - Claude prompt for changelog analysis
+
+### 🔧 Changed
+
+- Improved Windows compatibility by quoting git log format string in changelog-generator.js
+
+### 📚 Documentation
+
+- Updated help.js with bump-version command documentation and examples
+- Added version workflow examples (development → RC → release)
+- Updated CLAUDE.md with new utility modules and exports
+
+## [2.11.0] - 2026-02-03
+
+### ✨ Added
+
+- **Auto-push functionality in `create-pr` command** - Automatically detects and pushes unpublished branches before creating PR (#59, #34)
+    - Handles 3 scenarios: unpublished branch, unpushed commits, up-to-date branch
+    - Interactive confirmation prompt before pushing (configurable)
+    - Commit preview showing what will be pushed
+    - Diverged branch detection with helpful error message and resolution steps
+    - Never uses `git push --force` for security
+
+- **New configuration options** under `github.pr`:
+    - `autoPush: true` - Enable/disable auto-push (enabled by default)
+    - `pushConfirm: true` - Prompt for confirmation before push
+    - `showCommits: true` - Show commit preview before push
+    - `verifyRemote: true` - Verify remote exists before push
+
+- **New git-operations functions**:
+    - `getRemoteName()` - Get configured remote name (usually 'origin')
+    - `verifyRemoteExists()` - Check if remote is configured
+    - `getBranchPushStatus()` - Detect branch publish status and unpushed commits
+    - `pushBranch()` - Execute git push with upstream tracking
+
+### 🔧 Fixed
+
+- Issue #59: `create-pr` no longer fails when branch is not published to remote
+- Issue #34: Git push now integrated into create-pr workflow with proper error handling
+
+### 📚 Documentation
+
+- Updated CLAUDE.md with new git-operations functions and configuration options
+- Added comprehensive JSDoc comments for all new functions
+
 ## [2.10.0] - 2026-02-02
 
 ### 🏗️ Architecture - Modular CLI Refactoring
@@ -43,13 +128,13 @@ This release implements a **modular, decoupled, reusable** architecture for bett
 
 ### 🎯 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 |
+| 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
 
@@ -61,6 +146,7 @@ This release implements a **modular, decoupled, reusable** architecture for bett
 ### 🔧 Technical Details
 
 **New module structure:**
+
 ```
 lib/commands/
 ├── helpers.js        (389 lines) - Shared utilities
@@ -78,6 +164,7 @@ lib/commands/
 ```
 
 **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

package/README.md

@@ -31,9 +31,16 @@ git commit -m "auto"
 
 ```bash
 claude-hooks create-pr develop
+# Automatically pushes branch if unpublished (with confirmation)
 # Analyzes diff, generates title/description, creates PR on GitHub
 ```
 
+**Auto-push feature (v2.11.0):**
+- Detects unpublished branches or unpushed commits
+- Shows commit preview before pushing
+- Prompts for confirmation (configurable)
+- Handles diverged branches gracefully
+
 ### GitHub Token Setup
 
 ```bash
@@ -60,6 +67,65 @@ claude-hooks analyze-diff develop
 # Generates PR metadata without creating
 ```
 
+### Bump Version
+
+Automatic version management with CHANGELOG generation and Git tagging:
+
+```bash
+# Bump patch version (1.0.0 → 1.0.1)
+claude-hooks bump-version patch
+
+# Bump with suffix
+claude-hooks bump-version minor --suffix SNAPSHOT  # → 1.1.0-SNAPSHOT
+
+# Bump and generate CHANGELOG
+claude-hooks bump-version major --update-changelog
+
+# Preview without applying
+claude-hooks bump-version patch --dry-run
+```
+
+**What it does:**
+- Detects project type (Node.js, Maven, or monorepo with both)
+- Updates `package.json` and/or `pom.xml`
+- Generates CHANGELOG entry with Claude (analyzes commits)
+- Creates annotated Git tag with `v` prefix (e.g., `v2.7.0`)
+- Pushes tag to remote automatically
+
+**Version workflow:**
+```
+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:**
+- Validates version alignment (package.json, pom.xml, CHANGELOG, tags)
+- Detects and prompts to push unpushed tags
+- Warns if local version ≤ remote version
+
+### Generate CHANGELOG
+
+Standalone CHANGELOG generation (without version bump):
+
+```bash
+# Auto-detect version from package.json/pom.xml
+claude-hooks generate-changelog
+
+# Specific version with release marking
+claude-hooks generate-changelog 2.7.0 --release
+
+# Compare against different base branch
+claude-hooks generate-changelog --base-branch develop
+```
+
+**What it does:**
+- Analyzes commits since last tag using Claude
+- Categorizes by Conventional Commits types (feat, fix, refactor, etc.)
+- Generates Keep a Changelog format entries
+- Updates CHANGELOG.md automatically
+- Useful when `bump-version --update-changelog` fails
+
 ### Disable/Enable Hooks
 
 ```bash
@@ -221,7 +287,16 @@ Preset always wins - tech-stack specific has priority over user preferences.
   "version": "2.8.0",
   "preset": "backend",
   "overrides": {
-    "github": { "pr": { "defaultBase": "develop", "reviewers": ["user"] } },
+    "github": {
+      "pr": {
+        "defaultBase": "develop",
+        "reviewers": ["user"],
+        "autoPush": true,        // Auto-push unpublished branches (v2.11.0)
+        "pushConfirm": true,     // Prompt before push (v2.11.0)
+        "showCommits": true,     // Show commit preview (v2.11.0)
+        "verifyRemote": true     // Verify remote exists (v2.11.0)
+      }
+    },
     "subagents": { "batchSize": 2 }
   }
 }

package/bin/claude-hooks

@@ -22,6 +22,8 @@ import { runMigrateConfig } from '../lib/commands/migrate-config.js';
 import { runSetDebug } from '../lib/commands/debug.js';
 import { runShowTelemetry, runClearTelemetry } from '../lib/commands/telemetry-cmd.js';
 import { runShowHelp, runShowVersion } from '../lib/commands/help.js';
+import { runBumpVersion } from '../lib/commands/bump-version.js';
+import { runGenerateChangelog } from '../lib/commands/generate-changelog.js';
 
 /**
  * Main CLI router
@@ -75,6 +77,12 @@ async function main() {
         case 'migrate-config':
             await runMigrateConfig();
             break;
+        case 'bump-version':
+            await runBumpVersion(args.slice(1));
+            break;
+        case 'generate-changelog':
+            await runGenerateChangelog(args.slice(1));
+            break;
         case 'telemetry':
             // Handle subcommands: telemetry show, telemetry clear
             if (args[1] === 'show' || args[1] === undefined) {