🕹️ Usage

$ bunx relion -h

Usage: relion [options]

Options:
  -b <files>    Files to bump version in (def: ['package.json']; package.json is always included if exists)
  -v <version>  Release version (def: calculated from commits)
  -t <prefix>   Tag prefix (def: 'v')
  -d            Dry run (def: false)

Examples:
- `bunx relion -b src/manifest.json`
- `bunx relion -d -v 1.2.3`

Project: relion
Repo: github.com/kh4f/relion
Current tag: v0.42.1
Current version: 0.42.1
Parsed commits: 26
New version: 0.43.0
New tag: v0.43.0
------------------------------

('' to continue / 's' to skip)
About to write context to 'RELEASE.md'
About to bump version in files: package.json
About to commit changes: 'git commit -m "chore(release): v0.43.0"'
About to create a tag: 'git tag v0.43.0 -m "chore(release): v0.43.0"'

♻️ Workflow Steps

• Context: generates a RELEASE.md file with upcoming release metadata and commit log
• Bump: updates version in specified files
• Commit: creates a release commit
• Tag: creates an annotated release tag

---
tag: v0.33.0
prevTag: v0.32.1
date: Jan 10, 2026
repoURL: github.com/kh4f/relion
---

## Commit Log

[8f29acf] fix(versioner): ensure breaking changes take priority over features in release type calculation

Previously, if commits contained both features and breaking changes, features would be checked last and could incorrectly override the 'major' release type with 'minor'.
------------------------------
[e105d51] feat(config-merger): add `mergeConfigs` implementation and export

- Implement `mergeConfigs` to support merging config profiles in `config-merger.ts`
- Export `mergeConfigs` from `src/index.ts`

📚 Changelog Generation

Relion doesn’t format the changelog itself — it produces a release context that can be turned into a user‑friendly changelog with AI.

Recommended workflow:

1. Set up GitHub Copilot instruction and prompt:
   • .github/instructions/changelog-format.instructions.md
   • .github/prompts/generate-changelog.prompt.md
2. Run Relion to generate RELEASE.md with the release context
3. Review the release context, adjust as needed
4. Run the prompt in VSCode Copilot chat: /generate-changelog
5. Copilot produces a polished changelog entry based on the release context

##   [` 📦 v0.33.0  `](https://github.com/kh4f/relion/compare/v0.32.1...v0.33.0)

###   🎁 Features
- **Config merging utility**: added `mergeConfigs` implementation to support merging config profiles. [🡥](https://github.com/kh4f/relion/commit/e105d51)

###   🩹 Fixes
- **Correct release type calculation**: breaking changes now correctly take priority over features when determining the release type, preventing incorrect minor bumps. [🡥](https://github.com/kh4f/relion/commit/8f29acf)

#####    [Full Changelog](https://github.com/kh4f/relion/compare/v0.32.1...v0.33.0)  •  Jan 10, 2026