Create Changelog

Generate user-friendly changelogs from git commits following Keep a Changelog specification.

Workflow

1. Find last release point:

``bash git describe --tags --abbrev=0 2>/dev/null `` - If no tags found: use all commits

1. Collect commits since release:

``bash git log <last-tag>..HEAD --pretty=format:"%s" --no-merges ``

1. Categorize each commit into Keep a Changelog sections:

1. Write output starting DIRECTLY with version header. NO preamble, NO [Unreleased]:

```markdown ## [1.2.0] - 2025-03-15

### Added - Support for custom templates (#42) ```

1. Write to existing changelog file, or CHANGELOG.md if none exists. Prepend new entry below the file header.

Error Recovery

• If git log returns empty: inform user no changes found since last release
• If commit messages lack conventional prefixes: categorize by best guess, flag uncertain entries with <!-- review --> comment
• If existing changelog has non-standard format: preserve it, append new section at top