brel 0.1.2 → 0.3.0

package/CHANGELOG.md

@@ -1,4 +1,27 @@
-## [unreleased]
+## [0.3.0] - 2026-02-18
+
+### 🚀 Features
+
+- Version_selector dsl
+
+### 💼 Other
+
+- Cargo release
+## [0.2.0] - 2026-02-18
+
+### 🚀 Features
+
+- Tag after release
+- Tag templating
+
+### 🐛 Bug Fixes
+
+- Changelog generation tag
+
+### ⚙️ Miscellaneous Tasks
+
+- *(release)* V0.2.0
+## [0.1.2] - 2026-02-18
 
 ### 🐛 Bug Fixes
 

package/README.md

@@ -6,6 +6,7 @@
 
 - `brel init` generates a managed GitHub Actions workflow.
 - `brel release-pr` computes the next version, updates configured files, commits, pushes, and creates/updates a release PR.
+- `brel next-version` computes the next releasable version and prints it as plain SemVer.
 
 ## `release-pr` Prerequisites
 
@@ -50,6 +51,10 @@ pr_template_file = ".github/brel/release-pr-body.hbs"
 enabled = true
 output_file = "CHANGELOG.md"
 
+[release_pr.tagging]
+enabled = false
+tag_template = "v{version}"
+
 [release_pr.commit_author]
 name = "brel[bot]"
 email = "brel[bot]@users.noreply.github.com"
@@ -59,7 +64,7 @@ email = "brel[bot]@users.noreply.github.com"
 
 When you run `brel release-pr`:
 
-1. It finds the highest stable SemVer tag (`vX.Y.Z` or `X.Y.Z`).
+1. It finds the highest stable SemVer tag that matches `release_pr.tagging.tag_template` (default `v{version}`).
 2. If no valid tag exists, it uses `0.0.0`.
 3. It scans commits since that tag (or all commits when no tag exists).
 4. It picks one bump level from Conventional Commit signals:
@@ -68,9 +73,19 @@ When you run `brel release-pr`:
    - patch: `fix: ...`
 5. If no releasable commits are found, it exits successfully with no changes.
 
+`brel next-version` uses the same versioning rules:
+
+- when releasable commits exist, it prints the next version (for example `1.2.3`)
+- when none exist, it prints nothing and exits successfully
+
 ## How File Updates Work
 
-- `release_pr.version_updates` maps exact repo-relative file paths to dot-separated key paths.
+- `release_pr.version_updates` maps exact repo-relative file paths to selector paths.
+- Selector syntax:
+  - key: `version`
+  - nested key: `package.version`
+  - index selector: `packages[0].version`
+  - filter selector: `package[name=brel].version`
 - Supported file formats:
   - inferred from extension (`.json`, `.toml`)
   - or forced via `release_pr.format_overrides`
@@ -78,13 +93,28 @@ When you run `brel release-pr`:
   - a file is missing,
   - format cannot be determined,
   - parse fails,
-  - a key path does not exist,
-  - target value is not scalar.
+  - a selector is invalid,
+  - a selector matches no values,
+  - a selector uses index/filter on a non-array segment,
+  - a matched value is not a string.
+- Match behavior:
+  - all values matched by a selector are updated
+  - selectors do not create missing keys/paths
 
-Example key paths:
+Example selectors:
 
 - JSON: `"package.json" = ["version", "tooling.release.version"]`
+- JSON with filter: `"package.json" = ["package[name=brel].version"]`
 - TOML: `"Cargo.toml" = ["package.version"]`
+- Cargo.lock (explicit format override required):
+
+```toml
+[release_pr.version_updates]
+"Cargo.lock" = ["package[name=brel].version"]
+
+[release_pr.format_overrides]
+"Cargo.lock" = "toml"
+```
 
 ## Changelog Generation (`git-cliff`)
 
@@ -92,6 +122,10 @@ Example key paths:
 - Configure changelog behavior with `[release_pr.changelog]`:
   - `enabled` (default `true`)
   - `output_file` (default `"CHANGELOG.md"`)
+- Generated workflow behavior:
+  - computes `next-version` first via `brel next-version`
+  - runs `git-cliff` only when a next version exists
+  - passes `--unreleased --tag <rendered-tag-template>` so the newest changelog section is versioned instead of `[unreleased]`
 - If changelog generation is enabled, `brel release-pr` stages `output_file` in the release commit when that file exists.
 - Disable changelog generation:
 
@@ -106,7 +140,11 @@ enabled = false
 
 - Default branch pattern: `brel/release/v{{version}}`
   - Only `{{version}}` is supported as a token.
-- Commit message: `chore(release): vX.Y.Z`
+- `release_pr.tagging.tag_template` controls rendered release tags (default `v{version}`).
+  - `tag_template` accepts `{version}` and legacy `{{version}}` (normalized to `{version}`).
+  - `tag_template` must include exactly one version token.
+- Commit message: `chore(release): <rendered-tag>`
+- PR title: `Release <rendered-tag>`
 - Commit author defaults to:
   - `name = "brel[bot]"`
   - `email = "brel[bot]@users.noreply.github.com"`
@@ -118,6 +156,13 @@ For PRs:
 - If found, it updates that PR (continuity wins over recomputing branch name).
 - If not found, it creates a new PR.
 
+## Tagging on Merge
+
+- Optional config: `[release_pr.tagging] enabled = true` (default `false`).
+- Tag format config: `[release_pr.tagging] tag_template = "v{version}"` (default shown).
+- When enabled, the generated workflow listens for merged pull requests into the configured default branch.
+- If the merged PR is managed by `brel` and titled `Release <rendered-tag>`, the workflow validates it against `tag_template`, then creates and pushes that tag when it does not already exist.
+
 ## PR Body Templates
 
 If `release_pr.pr_template_file` is set, `brel` renders that Handlebars template.
@@ -125,6 +170,7 @@ If `release_pr.pr_template_file` is set, `brel` renders that Handlebars template
 Available variables:
 
 - `version`
+- `tag`
 - `base_branch`
 - `release_branch`
 - `commits` (array of `{ sha_short, subject }`)
@@ -156,3 +202,9 @@ Run with explicit config:
 ```bash
 brel release-pr --config ./configs/release.toml
 ```
+
+Preview the next release version:
+
+```bash
+brel next-version
+```

package/npm-shrinkwrap.json

@@ -23,7 +23,7 @@
       "hasInstallScript": true,
       "license": "MIT",
       "name": "brel",
-      "version": "0.1.2"
+      "version": "0.3.0"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -515,5 +515,5 @@
     }
   },
   "requires": true,
-  "version": "0.1.2"
+  "version": "0.3.0"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/better-releases/brel/releases/download/0.1.2",
+  "artifactDownloadUrl": "https://github.com/better-releases/brel/releases/download/0.3.0",
   "bin": {
     "brel": "run-brel.js"
   },
@@ -97,7 +97,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "0.1.2",
+  "version": "0.3.0",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"