cat projects/programs/carbon.html SOL.VIN JOURNAL v1.47-prod [ MFET2 ]

PROJECT // Carbon // Programs

Carbon

2026-10-01

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.yml compiled to GitHub-hyperlinked CHANGELOG.md with semantic category bucketing.
  • README Badge Engine: Auto-discovers CI workflows, licenses, Crystal constraints, and releases to render dynamic Markdown badges (<!-- carbon:badges -->) via badges.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).
SKILLS USED:
Crystal Git CI CD GitHub Actions