PROJECT // Carbon // Programs
Automated commit-based version control, human-friendly YAML changelogs, README badge engine, and Git release automation for Crystal shards.
Carbon automates repository versioning, changelog orchestration, and README badge synchronization across Crystal projects.
Highlights:
- Commit-Based Version Sync: Single source of truth aligning
shard.yml,version.cr, and Git tags with monotonic commit counts (carbon bump,carbon sync). - YAML Changelog Compiler: Structured
changelog.ymlcompiled to GitHub-hyperlinkedCHANGELOG.mdwith semantic category bucketing. - README Badge Engine: Auto-discovers CI workflows, licenses, Crystal constraints, and releases to render dynamic Markdown badges (
<!-- carbon:badges -->) viabadges.yml. - Non-Destructive Git Hooks: Safely chains into pre-commit and post-merge hooks using isolated markers without overwriting existing lint scripts.
- Repository Doctor: Audits shard health, detects version divergence, and auto-repairs metadata (
carbon doctor --fix).