Skip to content

Add CHANGELOG.md and adopt semantic versioning#87

Merged
dhilgaertner merged 2 commits intomainfrom
feature/crow-62-changelog-semver
Apr 5, 2026
Merged

Add CHANGELOG.md and adopt semantic versioning#87
dhilgaertner merged 2 commits intomainfrom
feature/crow-62-changelog-semver

Conversation

@dhilgaertner
Copy link
Copy Markdown
Contributor

@dhilgaertner dhilgaertner commented Apr 5, 2026

Summary

  • Create VERSION file as single source of truth for the project version
  • Add CHANGELOG.md using Keep a Changelog format, backfilled from git history as the 0.1.0 release
  • Update build scripts (generate-build-info.sh, bundle.sh) to read version from VERSION file with CROW_VERSION env var override for CI
  • Replace hardcoded version in CLI with generated CLIVersion.swift
  • Document semver policy, release process, and changelog contribution workflow in CONTRIBUTING.md

Test plan

  • make app builds successfully
  • crow --version prints 0.1.0 (from generated CLIVersion)
  • make release produces Crow.app with correct CFBundleShortVersionString and git-derived CFBundleVersion
  • CROW_VERSION=2.0.0 bash scripts/generate-build-info.sh overrides version correctly
  • CHANGELOG.md renders correctly on GitHub
  • CONTRIBUTING.md Versioning section is clear and complete

Closes #62

🤖 Generated with Claude Code

dhilgaertner and others added 2 commits April 5, 2026 15:34
Establish a versioning strategy with a single source of truth (VERSION
file) and a changelog following Keep a Changelog format, backfilled
from git history as the 0.1.0 release.

- Create VERSION file (0.1.0) as the canonical version source
- Update generate-build-info.sh to read VERSION and generate both
  BuildInfo.swift (with version + build number) and CLIVersion.swift
- Update bundle.sh to inject version and git-derived build number
  into Info.plist dynamically instead of hardcoding
- Update CrowCLI to use generated CLIVersion instead of hardcoded string
- Create CHANGELOG.md with backfilled 0.1.0 release notes
- Document versioning strategy and release process in CONTRIBUTING.md

Closes #62

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@dhilgaertner dhilgaertner requested a review from dgershman as a code owner April 5, 2026 23:17
@dhilgaertner dhilgaertner merged commit a62b1a2 into main Apr 5, 2026
2 checks passed
@dhilgaertner dhilgaertner deleted the feature/crow-62-changelog-semver branch April 5, 2026 23:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add CHANGELOG.md and adopt semantic versioning

1 participant