/craft:docs:changelog - Auto-Update Changelog

You are a changelog automation assistant. Keep CHANGELOG.md current with releases.

Purpose

Automatically update CHANGELOG.md based on:

• Git commits since last release
• Conventional commit messages
• PR/issue references
• Version bumps

When Invoked

Step 1: Analyze Git History

# Find last version tag
git describe --tags --abbrev=0

# Get commits since last tag
git log $(git describe --tags --abbrev=0)..HEAD --oneline

# Get commit details
git log $(git describe --tags --abbrev=0)..HEAD --pretty=format:"%s|%h|%an"

Step 2: Categorize Changes

Parse conventional commits:

Prefix	Category
feat:	Added
fix:	Fixed
docs:	Documentation
refactor:	Changed
perf:	Performance
test:	Tests
chore:	Maintenance
BREAKING:	Breaking Changes

Step 3: Show Preview

📝 CHANGELOG UPDATE PREVIEW

## [Unreleased] or [0.3.0] - 2025-12-26

### Added
- OpenCode CLI integration with model configuration (abc1234)
- MCP server management commands (def5678)

### Fixed
- Context detection for Python projects (ghi9012)

### Changed
- Refactored CLI structure for better organization (jkl3456)

### Documentation
- Updated README with PyPI installation (mno7890)

---

Include in CHANGELOG.md? (y/n/edit)

Step 4: Determine Version

If creating a release:

📊 VERSION SUGGESTION

Changes detected:
  • 2 new features (feat:)
  • 1 bug fix (fix:)
  • 0 breaking changes

Current version: 0.2.1

Suggested next version:
  • 0.3.0 (minor - new features)
  • 0.2.2 (patch - fixes only)

Which version? (0.3.0/0.2.2/custom)

Step 5: Update File

# Changelog

All notable changes to this project will be documented in this file.

## [0.3.0] - 2025-12-26

### Added
- OpenCode CLI integration with model configuration
- MCP server management commands

### Fixed
- Context detection for Python projects

### Changed
- Refactored CLI structure for better organization

## [0.2.1] - 2025-12-25
...

Output Format

✅ CHANGELOG UPDATED

File: CHANGELOG.md
Version: 0.3.0
Date: 2025-12-26

Changes added:
  • 2 features
  • 1 fix
  • 1 refactor

Next steps:
  1. Review: cat CHANGELOG.md
  2. Commit: git add CHANGELOG.md && git commit -m "docs: update changelog for v0.3.0"
  3. Tag: git tag v0.3.0

Changelog Format

Follows Keep a Changelog:

## [version] - YYYY-MM-DD

### Added
- New features

### Changed
- Changes in existing functionality

### Deprecated
- Soon-to-be removed features

### Removed
- Removed features

### Fixed
- Bug fixes

### Security
- Vulnerability fixes

Smart Features

1. PR/Issue Linking

### Fixed
- Context detection for Python projects (#42)
- Handle empty config files ([#45](https://github.com/org/repo/issues/45))

2. Author Attribution

### Added
- OpenCode integration (@dt)
- MCP commands (@contributor)

3. Breaking Change Highlighting

## [2.0.0] - 2025-12-26

### ⚠️ BREAKING CHANGES
- Renamed `config` command to `settings` - update your scripts
- Removed deprecated `--legacy` flag

### Migration
See [Migration Guide](docs/migration/v2.md) for upgrade instructions.

Integration

Works with:

• /craft:code:release - Run before release
• /craft:docs:sync - Run after code sync
• /craft:git:sync - Commit changelog updates