claude-git-hooks 2.21.0 → 2.30.2

package/CHANGELOG.md

@@ -5,9 +5,144 @@ 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.30.2] - 2026-03-18
+
+### 🔧 Changed
+- Authorization now uses GitHub's `role_name` field instead of legacy `permission` field for more accurate role mapping
+- Improved authorization error messages to show the actual GitHub permission that failed to map
+
+### 🐛 Fixed
+- Fixed role mapping to use `write` instead of `push` to match GitHub's current API role names
+
+
+## [2.30.1] - 2026-03-17
+
+### ✨ Added
+- Comprehensive Release Workflow Guide in CLAUDE.md documenting all workflow automation commands (check-coupling, create-release, shadow, revert-feature, close-release, back-merge) with step-by-step lifecycle, command details, and authorization model
+
+### 🔧 Changed
+- Increased timeout for AI help commands from 30s to 60s to improve reliability of claude-hooks help queries and issue reporting
+
+
+## [2.30.0] - 2026-03-17
+
+### ✨ Added
+- New `close-release` command for release-candidate finalization (#ISSUE-97) — soft-resets RC onto main, creates a single clean commit with feature list, force-pushes with lease, and creates PR to main with merge-commit strategy label
+- Support for `--auto-describe` flag to generate release description using Claude AI
+- Support for `--dry-run` flag to preview close-release actions without executing
+- Support for `--no-pr` flag to skip PR creation during release closure
+- New `back-merge` command for post-deploy branch synchronization (#105)
+
+
+## [2.29.0] - 2026-03-17
+
+### ✨ Added
+- Added `back-merge` command for post-deploy branch synchronization (#96) - automates the release close workflow: tags release, resets shadow to main, merges main into develop, deletes RC branches, and offers to restore reverted features for the next sprint
+- Added automatic conflict resolution for version files during back-merge (accepts source/main version)
+- Added CHANGELOG conflict handling during back-merge - stages with conflict markers and prompts user to continue or abort
+- Added revert follow-up feature that reads revert-log.json and offers to apply revert-the-revert for features removed from the closed RC
+- Added branch protection detection during back-merge push with helpful PR creation advice
+
+
+## [2.28.0] - 2026-03-17
+
+### ✨ Added
+- New `revert-feature` command to revert squash-merged features by task ID in release-candidate branches (#95)
+- Coupling detection when reverting features - warns if other RC commits share modified files
+- Revert log tracking at `.claude/revert-log.json` for back-merge workflows
+- Optional shadow branch sync after revert with `--update-shadow` flag
+- Dry-run mode for `revert-feature` to preview revert actions without executing
+- New `getCommitFiles()` utility in git-operations for retrieving files changed in a specific commit
+
+### 🐛 Fixed
+- Added debug logging for git log failures in revert-feature command to aid troubleshooting
+
+
+## [2.27.0] - 2026-03-17
+
+### ✨ Added
+- New `create-release` command to automate release-candidate branch creation from develop (#94)
+- Automatic version file discovery and bump during release creation
+- Git tag creation with skip logic if tag already exists
+- Shadow branch deployment integration after RC push
+- Support for `--dry-run` flag to preview release changes without executing
+- Support for `--no-shadow` flag to skip shadow deployment
+- Support for `--skip-push` flag for local-only branch creation
+- Support for `--update-changelog` flag to generate CHANGELOG entry during release
+- Comprehensive precondition validation: clean working directory, develop branch check, remote sync verification, existing RC detection
+
+
+## [2.26.0] - 2026-03-16
+
+### ✨ Added
+- Merge strategy auto-detection in `create-pr` command - automatically detects required merge strategy (squash vs merge commit) from branch naming conventions (feature/* → squash, release-candidate/* → merge-commit, hotfix/* → merge-commit, any → main → merge-commit)
+- Merge strategy labels (`merge-strategy:squash` or `merge-strategy:merge-commit`) automatically added to created PRs
+- Merge strategy display in PR preview showing detected strategy before creation
+- Body reminder prepended to PR description for merge-commit PRs warning about required merge method
+- Interactive merge strategy selection prompt when branch pattern is unknown or ambiguous
+- Shadow branch lifecycle management command (`claude-hooks shadow <analyze|reset|sync>`) for managing shadow branches - analyze divergence vs main and active RC, reset shadow to clean copy of main, or sync shadow with source branch (#101)
+
+
+## [2.25.0] - 2026-03-16
+
+### ✨ Added
+- New `shadow` command to manage the shadow branch lifecycle — analyze divergence vs main and active RC, reset shadow to a clean copy of main, or sync shadow with a source branch (RC, develop, feature)
+
+
+## [2.24.0] - 2026-03-16
+
+### ✨ Added
+
+- New `check-coupling` command to detect overlapping file changes across open PRs targeting a base branch
+- Role-based authorization system for workflow commands with fail-closed security model
+- Detailed error messages for authorization failures with clear guidance
+
+### 🔧 Changed
+
+- Extracted permissions repository path to constant for improved maintainability
+- Separated permissions repository owner validation from organization membership checks
+
+### 🐛 Fixed
+
+- Updated test constant values to ensure test suite passes
+
+## [2.23.0] - 2026-03-16
+
+### ✨ Added
+
+- Added role-based authorization system for protected workflow commands (create-release, close-release, back-merge, shadow, revert-feature, bump-version)
+- Added fail-closed authorization guard in CLI router that blocks commands when authorization cannot be verified
+- Added centralized permissions sourced from external GitHub repository (claude-hooks-permissions/permissions.json)
+- Added GitHub API functions for authorization: getAuthenticatedUser(), checkOrgMembership(), getCollaboratorPermission()
+- Added detailed error messages for all authorization failure scenarios (token issues, org membership, permission levels, repo governance)
+
+### 🔧 Changed
+
+- Extracted permissions source path to a constant (PERMISSIONS_SOURCE) for consistent error messaging
+- Separated permissions repository owner from organization membership check to support different hosting locations
+
+### 🔒 Security
+
+- Implemented fail-closed authorization design that blocks all commands on any authorization system error
+
+## [2.22.0] - 2026-03-12
+
+### ✨ Added
+
+- Branch lifecycle management functions in git-operations: checkoutBranch, mergeBranch, resetBranch, forcePush, deleteRemoteBranch, getDivergence
+- Utility functions for branch workflows: readFileFromRef, getLatestTag, isWorkingDirectoryClean, getActiveBranch
+- Debug diagnostics for judge fix application failures - diagnoses CRLF mismatches and search string issues
+- Debug dump output for judge decisions (written to .claude/out/judge-debug.json when debug mode enabled)
+
+### 🔧 Changed
+
+- Enhanced judge module with detailed failure diagnostics including line ending detection and hex dumps
+- Updated CLAUDE.md documentation to reflect expanded git-operations API
+
 ## [2.21.0] - 2026-03-10
 
 ### ✨ Added
+
 - New `analyze-pr` command to analyze GitHub PRs with team guidelines and post review comments (#86)
 - Linear ticket enrichment for PR analysis - automatically fetches ticket context when `[AUT-1234]` pattern found in PR title
 - New `setup-linear` command for interactive Linear token configuration
@@ -19,13 +154,14 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - Category normalization with fuzzy alias mapping for analysis results
 
 ### 🔧 Changed
+
 - Extended `github-api.js` with PR fetch, review creation, and URL parsing capabilities
 - Updated documentation (README, README-NPM, CLAUDE.md) with analyze-pr usage and architecture
 
-
 ## [2.20.0] - 2026-03-09
 
 ### ✨ Added
+
 - Intelligent batch orchestration for commits with 3+ files using Opus to semantically group files, assign per-batch models, and inject shared commit context
 - Auto-fix judge that evaluates all issues at any severity level, auto-applies search/replace fixes, and dismisses false positives - any unresolved issue blocks the commit (#85)
 - New `batch-info` command to display orchestration configuration and per-model average analysis speed from telemetry
@@ -36,6 +172,7 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - DIFF_ANALYSIS_ORCHESTRATION_PROMPT.md template for Opus batch grouping
 
 ### 🔧 Changed
+
 - Analysis routing now uses three-tier strategy: 1-2 files use sequential single call, 3+ files trigger intelligent orchestration
 - Judge now runs on all issues regardless of severity (previously only CRITICAL/BLOCKER blocked commits)
 - Resolution prompt file is only generated if issues remain after judge evaluation
@@ -47,13 +184,14 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - Judge can be disabled via `config.judge.enabled: false` to fall back to original quality gate
 
 ### 🗑️ Removed
+
 - Removed `subagents.batchSize` configuration option (orchestration now handled by Opus intelligence)
 - Removed `analyzeCodeParallel()` function from `claude-client.js` (replaced by orchestration-driven parallel execution)
 
-
 ## [2.19.0] - 2026-03-06
 
 ### ✨ Added
+
 - Shell autocompletion for all CLI commands, flags, and arguments — Bash, Zsh, Fish, and PowerShell (#78)
 - Command registry (`lib/cli-metadata.js`) — single source of truth for commands, flags, descriptions, and completion metadata
 - Four shell completion generators with per-command flag/arg awareness and dynamic branch completion for `analyze-diff` and `create-pr`
@@ -61,6 +199,7 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - Self-healing RC file updates — reinstall detects and replaces stale source lines (e.g., Windows backslash paths) automatically
 
 ### 🔧 Changed
+
 - Refactored `bin/claude-hooks` — replaced 130-line switch/case with declarative command registry lookup via `buildCommandMap()`
 - Shell source lines now use `$HOME`-relative paths for cross-platform compatibility (MINGW64, WSL, native Linux/macOS)
 - Completion source lines written to both `~/.bashrc` and `~/.bash_profile` (MINGW64 reads `.bash_profile` first)
@@ -69,46 +208,49 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 - Updated CLAUDE.md with cli-metadata.js documentation, exports table, and Command Registry design pattern
 
 ### 🐛 Fixed
+
 - Bash completions failing on MINGW64/Git Bash due to Windows backslash paths in source lines
 - PowerShell completions failing due to hardcoded Unix profile paths on Windows
 - PowerShell 5.1 `-Native` completers not firing for npm `.ps1` shims — added proxy function wrapper that re-exposes the command as `Function` type
 - PowerShell `[CompletionResult]` type accelerator not resolving in dot-sourced profile scripts
 
-
 ## [2.18.1] - 2026-03-04
 
 ### ✨ Added
+
 - Monorepo support for CHANGELOG discovery - discovers all CHANGELOG.md files and prompts to select when multiple are found (#77)
 - AI-powered help and issue creation system (#79)
 
 ### 🔧 Changed
+
 - Enhanced `walkDirectoryTree` utility function in file-utils.js for reusable directory traversal
 - Updated documentation to reflect monorepo CHANGELOG discovery capabilities
 
 ### 🐛 Fixed
-- Cross-platform path handling in git hooks directory resolution (normalized path separators)
 
+- Cross-platform path handling in git hooks directory resolution (normalized path separators)
 
 ## [2.18.0] - 2026-03-03
 
 ### ✨ Added
+
 - AI-powered help command - ask natural language questions about claude-hooks and get answers from documentation (`claude-hooks help "how do presets work?"`) (#79)
 - Interactive issue creation - guided GitHub issue creation using repository templates (`claude-hooks help --report-issue`) (#79)
 - New GitHub API functions for fetching file content, directory listings, and creating issues (`fetchFileContent`, `fetchDirectoryListing`, `createIssue`)
 - New prompt templates for AI help system: HELP_QUERY.md, HELP_REPORT_ISSUE.md, HELP_COMPOSE_ISSUE.md
 
 ### 🔧 Changed
+
 - Help command now supports three modes: static help (no args), AI-powered help (with question), and issue reporting (--report-issue)
 - Updated documentation (README.md, README-NPM.md, CLAUDE.md) to reflect new help and issue reporting features
 
-
 ## [2.17.2] - 2026-03-02
 
 ### 🐛 Fixed
+
 - Improved pom.xml version detection to correctly distinguish project version from dependency/property versions (#76)
 - Fixed false version mismatch errors for Maven submodules with inherited parent versions
 
-
 ## [2.17.1] - 2026-03-02
 
 ### 🐛 Fixed