chore: release v6.5.0

CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [6.5.0](https://github.com/jdx/usage/compare/v6.4.1..v6.5.0) - 2026-08-28
+
+### 🚀 Features
+
+- **(argv,derive)** add compiled clause support by [@jdx](https://github.com/jdx) in [#1320](https://github.com/jdx/usage/pull/1320)
+- **(complete)** complete sigil-prefixed positionals by [@jdx](https://github.com/jdx) in [#1319](https://github.com/jdx/usage/pull/1319)
+- **(spec,parse)** add sigil-classified positional arguments by [@jdx](https://github.com/jdx) in [#1322](https://github.com/jdx/usage/pull/1322)
+- **(spec,parse)** add repeatable clause groups by [@jdx](https://github.com/jdx) in [#1321](https://github.com/jdx/usage/pull/1321)
+
+### 🐛 Bug Fixes
+
+- **(zsh)** complete aliases with argument prefixes by [@halms](https://github.com/halms) in [#1330](https://github.com/jdx/usage/pull/1330)
+
+### New Contributors
+
+- @halms made their first contribution in [#1330](https://github.com/jdx/usage/pull/1330)
+
 ## [6.4.1](https://github.com/jdx/usage/compare/v6.4.0..v6.4.1) - 2026-08-26
 
 ### 🐛 Bug Fixes

Cargo.toml

@@ -42,20 +42,20 @@ license = "MIT"
 [workspace.dependencies]
 clap_usage = { path = "./clap_usage", version = "5.0.0" }
 usage-cli = { path = "./cli" }
-usage-argv = { path = "./argv", version = "6.4.1" }
-usage-config = { path = "./config", version = "6.4.1" }
-usage-derive = { path = "./derive", version = "6.4.1" }
+usage-argv = { path = "./argv", version = "6.5.0" }
+usage-config = { path = "./config", version = "6.5.0" }
+usage-derive = { path = "./derive", version = "6.5.0" }
 # No features, and defaults off. A feature named here is inherited by every member that writes
 # `workspace = true` and inlines into their published manifests — so `clap` and `validation`
 # reached members that use neither, one of them an adopter's build script. Defaults
 # are off rather than absent because cargo *ignores* a member's `default-features = false` unless
 # the workspace declaration sets it too, and warns that it may become a hard error. Members name
 # what they need, `docs` included.
-usage-lib = { path = "./lib", version = "6.4.1", default-features = false }
-usage-rs = { path = "./usage-rs", version = "6.4.1" }
-usage-dynamic = { path = "./usage-dynamic", version = "6.4.1" }
-usage-test = { path = "./test", version = "6.4.1" }
-usage-validation = { path = "./validation", version = "6.4.1" }
+usage-lib = { path = "./lib", version = "6.5.0", default-features = false }
+usage-rs = { path = "./usage-rs", version = "6.5.0" }
+usage-dynamic = { path = "./usage-dynamic", version = "6.5.0" }
+usage-test = { path = "./test", version = "6.5.0" }
+usage-validation = { path = "./validation", version = "6.5.0" }
 
 [workspace.metadata.release]
 allow-branch = ["main"]

argv/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "usage-argv"
 description = "Zero-allocation argv parser for usage specs"
-version = "6.4.1"
+version = "6.5.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

cli/Cargo.toml

@@ -2,7 +2,7 @@
 name = "usage-cli"
 edition = "2021"
 rust-version = "1.91"
-version = "6.4.1"
+version = "6.5.0"
 description = "CLI for working with usage-based CLIs"
 license = { workspace = true }
 authors = { workspace = true }

cli/usage.usage.kdl

@@ -2,7 +2,7 @@
 min_usage_version "6.5"
 name usage
 bin usage
-version "6.4.1"
+version "6.5.0"
 repository "https://github.com/jdx/usage"
 source_code_link_template #"""
 {%- set path = path | replace(from='-', to='_') -%}

config/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "usage-config"
 description = "Layered configuration resolution for usage specs, with provenance"
-version = "6.4.1"
+version = "6.5.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

derive/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "usage-derive"
 description = "Derive macro that compiles a CLI definition into parse tables and a usage spec"
-version = "6.4.1"
+version = "6.5.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

docs/cli/reference/commands.json

@@ -2014,7 +2014,7 @@
     "sources": {},
     "files": []
   },
-  "version": "6.4.1",
+  "version": "6.5.0",
   "usage": "Usage: usage <COMMAND>\n       usage --completions <COMPLETIONS>\n       usage --usage-spec",
   "complete": {},
   "source_code_link_template": "{%- set path = path | replace(from='-', to='_') -%}\n{%- if cmd.subcommands | length > 0 -%}\n{%- set path = path ~ \"/mod.rs\" -%}\n{%- elif path in [\"bash\", \"fish\", \"powershell\", \"zsh\"] -%}\n{%- set path = \"shell.rs\" -%}\n{%- else -%}\n{%- set path = path ~ \".rs\" -%}\n{%- endif -%}\nhttps://github.com/jdx/usage/blob/main/cli/src/cli/{{path}}",

docs/cli/reference/index.md

@@ -4,7 +4,7 @@
 
 **Usage:** `usage [--completions <COMPLETIONS>] [--usage-spec] <SUBCOMMAND>`
 
-**Version:** 6.4.1
+**Version:** 6.5.0
 
 **Repository:** https://github.com/jdx/usage
 

lib/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "usage-lib"
 edition = "2021"
-version = "6.4.1"
+version = "6.5.0"
 rust-version = "1.91"
 include = [
     "/Cargo.toml",

test/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "usage-test"
 description = "Test helpers for CLIs built with usage"
-version = "6.4.1"
+version = "6.5.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

usage-dynamic/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "usage-dynamic"
 description = "Runtime command catalogs for usage-rs applications"
-version = "6.4.1"
+version = "6.5.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }
@@ -12,7 +12,7 @@ license = { workspace = true }
 
 [dependencies]
 usage-argv = { workspace = true, features = ["spec", "complete"] }
-usage-parser = { package = "usage-lib", path = "../lib", version = "6.4.1", default-features = false, features = ["cli-help"] }
+usage-parser = { package = "usage-lib", path = "../lib", version = "6.5.0", default-features = false, features = ["cli-help"] }
 
 [package.metadata.release]
 shared-version = true

usage-rs/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "usage-rs"
 description = "A compiled CLI parser for Rust, built on usage specs"
-version = "6.4.1"
+version = "6.5.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

validation/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "usage-validation"
 description = "Portable expression validation for usage specs"
-version = "6.4.1"
+version = "6.5.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }