Phase 1: Conventional Commits & Auto-Categorization #627

Overview

Implement automated changelog entry generation from conventional commits and PR labels. This phase adds parsing capabilities and auto-categorization without breaking existing workflows.

Deliverables

Modules to Create

1. commitParser.js - Parse conventional commit format (feat, fix, docs, etc.)
2. categoryMapper.js - Map commit types/PR labels to Keep a Changelog sections
3. changelogBuilder.js - Build and insert changelog entries
4. changelog-cli.js - CLI interface for changelog operations
5. validate-conventional-commits.js - Validation script for CI

Features

• Parse all 8 conventional commit types (feat, fix, docs, style, refactor, perf, test, chore)
• Auto-categorize entries based on commit type and PR labels
• Generate PR/author links in changelog entries
• Support dry-run mode
• Graceful fallback for non-conventional commits

Testing

• Unit tests for each module (>85% coverage)
• Integration tests with release agent
• CLI command validation

Success Criteria

• All conventional commit types supported
• CLI commands functional
• Backward compatible with existing release workflow
• Test coverage >85%

Related Issues

• Release Workflow: Post-release changelog validation missing #592 (Release Workflow Validation)

Implementation Notes

See detailed architecture plan in previous conversation for:

• File structure and organization
• Function specifications
• Integration points
• Risk mitigation strategies