Release Notes - v0.5.0¶
Overview¶
This release introduces LLM-assisted changelog generation with new CLI commands optimized for AI workflows, reducing token usage by ~5x compared to raw git log output. It also adds a comprehensive MkDocs documentation site.
Highlights¶
LLM-Optimized Git Parsing¶
New parse-commits command provides structured, token-efficient git history:
Output is designed for LLM consumption:
Category Suggestions¶
New suggest-category command helps classify commits:
schangelog suggest-category "feat(api): add rate limiting endpoint"
# Output: added (confidence: high)
Rich Validation Output¶
Validation now provides actionable JSON output for programmatic use:
Returns structured errors with line numbers, field paths, and fix suggestions.
MkDocs Documentation Site¶
Full documentation site with Material theme:
- Specification docs
- LLM integration guide
- PRDs for future features (localization, rendering)
- Release notes archive
New Commands¶
| Command | Description |
|---|---|
schangelog parse-commits |
Parse git history in LLM-optimized format |
schangelog suggest-category |
Suggest changelog category for a commit |
New CLI Flags¶
| Flag | Command | Description |
|---|---|---|
--since |
parse-commits | Start from tag/commit |
--until |
parse-commits | End at tag/commit |
--json |
validate | Output errors as JSON |
Documentation¶
- LLM Guide — Prompts and workflows for AI-assisted generation
- PRD: Localization — Planned i18n support
- PRD: Rendering — Markdown output targets
Breaking Changes¶
None. This release is fully backwards compatible.
What's Next¶
v0.6.0 will focus on Localization:
- Localized section headers (Added → Ajouté, Fixed → Corrigé)
- 25+ language support matching Keep a Changelog translations
- Embedded locale files via
//go:embed
Installation¶
# Via Go
go install github.com/grokify/structured-changelog/cmd/schangelog@v0.5.0
# Via Homebrew
brew install grokify/tap/structured-changelog