feat: Add automated changelog date management

- Add Rake tasks for changelog management:
  - changelog:update_date - Updates all entries with current date
  - changelog:new_version - Adds new version entry with current date
  - release:prepare - Comprehensive release preparation

- Add Ruby script for direct changelog date updates
- Add optional pre-commit hook for automatic date updates
- Update GitHub Actions release workflow to auto-update dates
- Add comprehensive documentation for changelog automation

Benefits:
- Prevents date inconsistencies (like 2024 dates in 2025)
- Automates tedious manual date entry
- Integrates with CI/CD pipeline
- Uses system time for accuracy and consistency

Fixes the issue where CHANGELOG.md showed 2024-12-15 for v1.0.0
when current date is 2025-09-15

Author: rschumann

.github/workflows/release.yml

@@ -19,6 +19,13 @@ jobs:
         ruby-version: '3.2'
         bundler-cache: true
 
+    - name: Extract version from tag
+      id: version
+      run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+    - name: Update changelog with current date
+      run: ruby scripts/update_changelog_date.rb ${{ steps.version.outputs.VERSION }}
+
     - name: Run full test suite
       run: bundle exec rake ci
       env:

CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 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).
 
-## [1.0.0] - 2024-12-15
+## [1.0.0] - 2025-09-15
 
 ### Added
 - Complete A2A Protocol v0.3.0 implementation

Rakefile

@@ -65,6 +65,97 @@ end
 desc "Run all tests for CI"
 task ci: %w[rubocop spec:unit spec:integration spec:compliance]
 
+# Changelog management
+namespace :changelog do
+  desc "Update changelog with current date for unreleased version"
+  task :update_date do
+    changelog_path = "CHANGELOG.md"
+    current_date = Time.now.strftime("%Y-%m-%d")
+    
+    unless File.exist?(changelog_path)
+      puts "CHANGELOG.md not found!"
+      exit 1
+    end
+    
+    content = File.read(changelog_path)
+    
+    # Replace any unreleased or incorrect dates with current date
+    # Pattern matches: ## [version] - YYYY-MM-DD or ## [version] - Unreleased
+    updated_content = content.gsub(/^(## \[[^\]]+\]) - (?:\d{4}-\d{2}-\d{2}|Unreleased)$/) do |match|
+      version_part = match.split(' - ').first
+      "#{version_part} - #{current_date}"
+    end
+    
+    if content != updated_content
+      File.write(changelog_path, updated_content)
+      puts "Updated CHANGELOG.md with current date: #{current_date}"
+    else
+      puts "No changelog dates needed updating"
+    end
+  end
+  
+  desc "Add new version entry to changelog"
+  task :new_version, [:version] do |task, args|
+    version = args[:version] || ENV['VERSION']
+    
+    unless version
+      puts "Please provide a version: rake changelog:new_version[1.0.1] or VERSION=1.0.1 rake changelog:new_version"
+      exit 1
+    end
+    
+    changelog_path = "CHANGELOG.md"
+    current_date = Time.now.strftime("%Y-%m-%d")
+    
+    unless File.exist?(changelog_path)
+      puts "CHANGELOG.md not found!"
+      exit 1
+    end
+    
+    content = File.read(changelog_path)
+    
+    # Find the first ## heading and insert new version before it
+    new_entry = <<~ENTRY
+      ## [#{version}] - #{current_date}
+
+      ### Added
+      - 
+
+      ### Changed
+      - 
+
+      ### Fixed
+      - 
+
+      ENTRY
+    
+    # Insert after the header but before the first version entry
+    updated_content = content.sub(/^(# Changelog.*?\n\n)/m, "\\1#{new_entry}")
+    
+    File.write(changelog_path, updated_content)
+    puts "Added new version #{version} to CHANGELOG.md with date #{current_date}"
+  end
+end
+
+# Release tasks
+namespace :release do
+  desc "Prepare release with updated changelog date"
+  task :prepare, [:version] do |task, args|
+    version = args[:version] || ENV['VERSION']
+    
+    if version
+      Rake::Task["changelog:new_version"].invoke(version)
+    else
+      Rake::Task["changelog:update_date"].invoke
+    end
+    
+    puts "Release preparation complete!"
+    puts "Don't forget to:"
+    puts "1. Update version in lib/a2a/version.rb"
+    puts "2. Commit changes"
+    puts "3. Create and push git tag: git tag v#{version || 'X.X.X'} && git push origin v#{version || 'X.X.X'}"
+  end
+end
+
 # Default task
 task default: :spec
 

docs/CHANGELOG_AUTOMATION.md

@@ -0,0 +1,89 @@
+# Changelog Automation
+
+This project includes automated tools to manage changelog dates and prevent date inconsistencies.
+
+## Available Tools
+
+### 1. Rake Tasks
+
+Update changelog dates automatically:
+
+```bash
+# Update all changelog entries with current date
+rake changelog:update_date
+
+# Add a new version entry with current date
+rake changelog:new_version[1.0.1]
+
+# Prepare a release (updates changelog and provides next steps)
+rake release:prepare[1.0.1]
+```
+
+### 2. Ruby Script
+
+Direct script execution:
+
+```bash
+# Update all entries
+ruby scripts/update_changelog_date.rb
+
+# Update specific version
+ruby scripts/update_changelog_date.rb 1.0.1
+```
+
+### 3. Pre-commit Hook (Optional)
+
+Automatically update changelog dates when committing:
+
+```bash
+# Install the pre-commit hook
+ln -s ../../scripts/pre-commit-changelog .git/hooks/pre-commit
+```
+
+### 4. GitHub Actions Integration
+
+The release workflow automatically updates changelog dates when creating releases from git tags.
+
+## Usage Examples
+
+### Adding a New Release
+
+1. **Manual approach:**
+   ```bash
+   rake changelog:new_version[1.2.0]
+   # Edit CHANGELOG.md to add your changes
+   git add CHANGELOG.md
+   git commit -m "Add changelog for v1.2.0"
+   ```
+
+2. **With release preparation:**
+   ```bash
+   rake release:prepare[1.2.0]
+   # Follow the printed instructions
+   ```
+
+### Fixing Date Issues
+
+If you notice incorrect dates in the changelog:
+
+```bash
+rake changelog:update_date
+```
+
+This will update all entries to use the current system date.
+
+## Benefits
+
+- **Consistency**: All dates use the current system time
+- **Automation**: No manual date entry required
+- **CI/CD Integration**: Automatic updates during releases
+- **Developer Friendly**: Optional pre-commit hooks for convenience
+
+## Date Format
+
+All dates use the ISO 8601 format: `YYYY-MM-DD` (e.g., `2025-09-15`)
+
+This format is:
+- Sortable
+- Unambiguous
+- Follows the [Keep a Changelog](https://keepachangelog.com/) standard

scripts/pre-commit-changelog

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Pre-commit hook to automatically update changelog dates
+# To install: ln -s ../../scripts/pre-commit-changelog .git/hooks/pre-commit
+
+set -e
+
+# Check if CHANGELOG.md is being committed
+if git diff --cached --name-only | grep -q "CHANGELOG.md"; then
+    echo "Updating CHANGELOG.md dates..."
+    ruby scripts/update_changelog_date.rb
+    
+    # Add the updated changelog back to the commit
+    git add CHANGELOG.md
+    echo "CHANGELOG.md dates updated automatically"
+fi

scripts/update_changelog_date.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Script to automatically update changelog dates with current system time
+# Usage: ruby scripts/update_changelog_date.rb [version]
+
+require 'time'
+
+def update_changelog_date(version = nil)
+  changelog_path = 'CHANGELOG.md'
+  current_date = Time.now.strftime('%Y-%m-%d')
+  
+  unless File.exist?(changelog_path)
+    puts "ERROR: CHANGELOG.md not found!"
+    exit 1
+  end
+  
+  content = File.read(changelog_path)
+  original_content = content.dup
+  
+  if version
+    # Update specific version
+    pattern = /^(## \[#{Regexp.escape(version)}\]) - (?:\d{4}-\d{2}-\d{2}|Unreleased)$/
+    content.gsub!(pattern, "\\1 - #{current_date}")
+    puts "Updated version #{version} to date #{current_date}"
+  else
+    # Update all versions with incorrect or unreleased dates
+    content.gsub!(/^(## \[[^\]]+\]) - (?:\d{4}-\d{2}-\d{2}|Unreleased)$/) do |match|
+      version_part = match.split(' - ').first
+      "#{version_part} - #{current_date}"
+    end
+    puts "Updated all changelog entries to current date: #{current_date}"
+  end
+  
+  if content != original_content
+    File.write(changelog_path, content)
+    puts "CHANGELOG.md updated successfully"
+  else
+    puts "No changes needed in CHANGELOG.md"
+  end
+end
+
+# Main execution
+if __FILE__ == $0
+  version = ARGV[0]
+  update_changelog_date(version)
+end