cdk/misc/recipes/changelog-from-commits.yaml

version: 1.0.0
title: Update Changelog from last commits
description: A custom recipe to update changelog from the last X commits
instructions: Analyze recent Git commits and automatically update project changelogs following Keep a Changelog format. Read commit history using git log, understand the nature of code changes (API refactoring, new features, bug fixes, etc.), and add appropriately categorized entries to the Unreleased section. Use the git author's username for attribution and follow established changelog patterns including proper formatting with contributor links. Requires git command line tools and file editing capabilities.
prompt: |
  You are tasked with updating the CHANGELOG.md file based on recent Git commits. Follow these instructions:

  ## Analysis Process:
  1. **Get commit count**: Check if a COMMITS environment variable was provided (default to 5 if not specified)
  2. **Read recent commits**: Use `git log -n X` to analyze the last X commits (where X is the number specified by user or default)
  3. **Get git author**: Use `git config --get user.name` to get the author name for attribution
  4. **Analyze change types**: Categorize changes into:
     - **Added**: New features, new functions, new files, new functionality
     - **Changed**: Modifications to existing functionality, refactoring, API changes, dependency updates
     - **Fixed**: Bug fixes, error handling improvements, corrections
     - **Removed**: Deleted files, deprecated functions, removed dependencies

  ## CHANGELOG.md Update Requirements:
  1. **Preserve existing format**: Keep the exact formatting style of the existing CHANGELOG.md
  2. **Update Unreleased section**: Add new entries to the "## [Unreleased]" section only
  3. **Use proper categories**: Add entries under the appropriate subsections (Added, Changed, Fixed, Removed)
  4. **Follow format pattern**: Each entry should follow this exact format:
     ```
     - component: Description of change ([author]).
     ```
  5. **Author attribution**: Use the git author name in square brackets at the end of each entry
  6. **Component identification**: Identify the relevant component (e.g., "cdk", "cashu", "cdk-cli", etc.) from file paths
  7. **Maintain formatting**: 
     - Use proper bullet points with hyphens
     - Maintain consistent spacing
     - Keep entries concise but descriptive
     - End each entry with period before author attribution

  ## Example Entry Format:
  ```markdown
  ### Added
  - cdk: New keyset refresh functionality with improved error handling ([thesimplekid]).

  ### Changed  
  - cdk: Refactored wallet keyset management for better performance ([thesimplekid]).

  ### Fixed
  - cdk-cli: Fixed token parsing error for malformed inputs ([thesimplekid]).
  ```

  ## Important Guidelines:
  - **DO NOT** modify any existing changelog entries
  - **DO NOT** change the structure or format of the changelog
  - **ONLY** add new entries to the Unreleased section
  - **DO NOT** add duplicate entries
  - **BE SPECIFIC** about what changed, not just which files
  - **FOCUS** on user-facing changes and important internal improvements
  - **IGNORE** trivial changes like whitespace, comments, or formatting unless they're significant

  ## Steps to Execute:
  1. Check for COMMITS environment variable or ask user for the number of recent commits to analyze (default to 5)
  2. Read current CHANGELOG.md file to understand format
  3. Get git author name  
  4. Analyze recent commits with `git log -n X --pretty=format:"%h %s"`
  5. For each commit, examine detailed changes with `git show COMMIT_HASH`
  6. Categorize and write appropriate changelog entries
  7. Update the CHANGELOG.md file preserving all existing content
extensions:
- type: builtin
  name: developer
  display_name: Developer
  timeout: 300
  bundled: true
activities:
- Update changelog from recent commits
- Analyze API refactoring commits
- Add new feature entries
- Categorize bug fix changes
- Format contributor attributions
author:
  contact: thesimplekid