improve release notes and documentation

- Enhanced GitHub Actions release workflow with richer release notes
- Updated CHANGELOG.md with current version (0.2.3) details
- Updated README.md to reflect Husky v9 peer dependency requirement
- Added automatic commit history and installation info to release notes

Author: 253eosam

.github/workflows/release.yml

@@ -68,16 +68,41 @@ jobs:
         id: changelog
         run: |
           VERSION="${{ steps.version.outputs.version }}"
+          CHANGELOG_CONTENT=""
+
+          # Try to extract from CHANGELOG.md first
           if [ -f "CHANGELOG.md" ]; then
             # Extract changelog for current version
             awk "/^## \[$VERSION\]/{flag=1; next} /^## \[/{flag=0} flag" CHANGELOG.md > current_changelog.md
             if [ -s current_changelog.md ]; then
-              echo "changelog<<EOF" >> $GITHUB_OUTPUT
-              cat current_changelog.md >> $GITHUB_OUTPUT
-              echo "EOF" >> $GITHUB_OUTPUT
-            else
-              echo "changelog=🚀 Release $VERSION" >> $GITHUB_OUTPUT
+              echo "📋 **What's Changed**" > release_notes.md
+              echo "" >> release_notes.md
+              cat current_changelog.md >> release_notes.md
+              echo "" >> release_notes.md
             fi
+          fi
+
+          # Generate commit-based changelog since last tag
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          if [ -n "$PREV_TAG" ]; then
+            echo "## 📝 Commits since $PREV_TAG" >> release_notes.md
+            echo "" >> release_notes.md
+            git log --pretty=format:"- %s (%h)" $PREV_TAG..HEAD >> release_notes.md
+            echo "" >> release_notes.md
+          fi
+
+          # Add package info
+          echo "" >> release_notes.md
+          echo "## 📦 Installation" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "\`\`\`bash" >> release_notes.md
+          echo "npm install @253eosam/commit-from-branch@$VERSION" >> release_notes.md
+          echo "\`\`\`" >> release_notes.md
+
+          if [ -f "release_notes.md" ]; then
+            echo "changelog<<EOF" >> $GITHUB_OUTPUT
+            cat release_notes.md >> $GITHUB_OUTPUT
+            echo "EOF" >> $GITHUB_OUTPUT
           else
             echo "changelog=🚀 Release $VERSION" >> $GITHUB_OUTPUT
           fi

CHANGELOG.md

@@ -2,7 +2,32 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.2.0] - 2025-01-10
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.3] - 2024-09-16
+
+### ✨ New Features
+- **Peer Dependency Support**: Added husky@^9.0.0 as peer dependency for clearer version requirements
+- **Enhanced Error Messages**: Improved installation guidance with clear step-by-step instructions
+
+### 🔧 Code Quality Improvements
+- **Declarative Architecture**: Refactored cli.ts and init.ts from procedural to declarative approach
+- **Strategy Pattern**: Implemented strategy pattern for Husky initialization scenarios
+- **Command Handler Pattern**: Clean command routing in CLI with declarative handlers
+- **Simplified Validation**: Leveraged npm's peer dependency warnings instead of complex version checking
+
+### 🧪 Testing
+- **Updated Test Suite**: Fixed test expectations to match new behavior
+- **Integration Tests**: All 31 tests passing with improved coverage
+
+### 📚 Documentation
+- **CLAUDE.md**: Added comprehensive guide for future Claude Code instances
+- **Architecture Documentation**: Detailed explanation of functional pipeline and design patterns
+
+## [0.2.0] - 2024-09-16
 
 ### 🎉 Major Refactoring - Declarative Architecture
 

README.md

@@ -20,11 +20,14 @@ Automatically formats your commit messages based on your branch name, extracting
 npm install @253eosam/commit-from-branch --save-dev
 ```
 
+> **Note**: This package requires Husky v9 as a peer dependency. npm will automatically warn you if it's not installed.
+
 ## Quick Start
 
-1. **Install Husky** (if not already installed):
+1. **Install Husky v9** (if not already installed):
 
 ```bash
+npm install --save-dev husky@^9.0.0
 npx husky init
 ```
 
@@ -198,7 +201,7 @@ initHusky("/path/to/repo");
 
 - Node.js >= 16
 - Git repository
-- Husky (for automatic setup)
+- Husky v9 (peer dependency)
 
 ## Contributing