From 9d0fb76f3b2eb75cf7ac6a62684bd3a5ffff3972 Mon Sep 17 00:00:00 2001
From: mise-en-dev <123107610+mise-en-dev@users.noreply.github.com>
Date: Mon, 19 Oct 2026 08:14:34 +0000
Subject: [PATCH] chore: release v7.1.0

---
 CHANGELOG.md                                   | 15 +++++++++++++++
 Cargo.lock                                     | 18 +++++++++---------
 Cargo.toml                                     | 16 ++++++++--------
 argv/Cargo.toml                                |  2 +-
 cli/Cargo.toml                                 |  2 +-
 cli/usage.usage.kdl                            |  2 +-
 config/Cargo.toml                              |  2 +-
 derive/Cargo.toml                              |  2 +-
 docs/cli/reference/commands.json               |  2 +-
 docs/cli/reference/index.md                    |  2 +-
 lib/Cargo.toml                                 |  2 +-
 test/Cargo.toml                                |  2 +-
 usage-dynamic/Cargo.toml                       |  4 ++--
 usage-rs/Cargo.toml                            |  2 +-
 .../tests/fixtures/runtime-identity/Cargo.lock |  6 +++---
 validation/Cargo.toml                          |  2 +-
 16 files changed, 48 insertions(+), 33 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index fd8b8f38d..8e9261f71 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,20 @@
 # Changelog
 
+## [7.1.0](https://github.com/jdx/usage/compare/v7.0.2..v7.1.0) - 2026-10-19
+
+### 🚀 Features
+
+- **(spec)** add Effect v4 CLI exporter by [@jdx](https://github.com/jdx) in [#1564](https://github.com/jdx/usage/pull/1564)
+
+### 🐛 Bug Fixes
+
+- **(bash)** escape completion candidates so the command receives them as offered by [@jdx](https://github.com/jdx) in [#1566](https://github.com/jdx/usage/pull/1566)
+
+### 📦️ Dependency Updates
+
+- lock file maintenance by [@renovate[bot]](https://github.com/renovate[bot]) in [#1567](https://github.com/jdx/usage/pull/1567)
+- lock file maintenance by [@renovate[bot]](https://github.com/renovate[bot]) in [#1568](https://github.com/jdx/usage/pull/1568)
+
 ## [7.0.2](https://github.com/jdx/usage/compare/v7.0.1..v7.0.2) - 2026-10-16
 
 ### 🐛 Bug Fixes
diff --git a/Cargo.lock b/Cargo.lock
index 02c743c14..0fce8414c 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -2058,11 +2058,11 @@ checksum = "b4ac048d71ede7ee76d585517add45da530660ef4390e49b098733c6e897f254"
 
 [[package]]
 name = "usage-argv"
-version = "7.0.2"
+version = "7.1.0"
 
 [[package]]
 name = "usage-cli"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "assert_cmd",
  "ctor",
@@ -2090,7 +2090,7 @@ dependencies = [
 
 [[package]]
 name = "usage-config"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "serde_json",
  "toml",
@@ -2117,7 +2117,7 @@ dependencies = [
 
 [[package]]
 name = "usage-derive"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "heck",
  "proc-macro2",
@@ -2127,7 +2127,7 @@ dependencies = [
 
 [[package]]
 name = "usage-dynamic"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "futures",
  "usage-argv",
@@ -2137,7 +2137,7 @@ dependencies = [
 
 [[package]]
 name = "usage-lib"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "clap",
  "criterion",
@@ -2166,7 +2166,7 @@ dependencies = [
 
 [[package]]
 name = "usage-rs"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "serde",
  "shell-words",
@@ -2190,14 +2190,14 @@ dependencies = [
 
 [[package]]
 name = "usage-test"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "usage-argv",
 ]
 
 [[package]]
 name = "usage-validation"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "expr-lang",
 ]
diff --git a/Cargo.toml b/Cargo.toml
index 7fb9e0318..98ab7090a 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -43,20 +43,20 @@ license = "MIT"
 [workspace.dependencies]
 clap_usage = { path = "./clap_usage", version = "5.0.0" }
 usage-cli = { path = "./cli" }
-usage-argv = { path = "./argv", version = "7.0.2", default-features = false }
-usage-config = { path = "./config", version = "7.0.2" }
-usage-derive = { path = "./derive", version = "7.0.2" }
+usage-argv = { path = "./argv", version = "7.1.0", default-features = false }
+usage-config = { path = "./config", version = "7.1.0" }
+usage-derive = { path = "./derive", version = "7.1.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 = "7.0.2", default-features = false }
-usage-rs = { path = "./usage-rs", version = "7.0.2" }
-usage-dynamic = { path = "./usage-dynamic", version = "7.0.2" }
-usage-test = { path = "./test", version = "7.0.2" }
-usage-validation = { path = "./validation", version = "7.0.2" }
+usage-lib = { path = "./lib", version = "7.1.0", default-features = false }
+usage-rs = { path = "./usage-rs", version = "7.1.0" }
+usage-dynamic = { path = "./usage-dynamic", version = "7.1.0" }
+usage-test = { path = "./test", version = "7.1.0" }
+usage-validation = { path = "./validation", version = "7.1.0" }
 
 [workspace.metadata.release]
 allow-branch = ["main"]
diff --git a/argv/Cargo.toml b/argv/Cargo.toml
index 78bef72ad..b719ee762 100644
--- a/argv/Cargo.toml
+++ b/argv/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-argv"
 description = "Zero-allocation argv parser for usage specs"
-version = "7.0.2"
+version = "7.1.0"
 edition = "2024"
 rust-version = "1.91"
 homepage = { workspace = true }
diff --git a/cli/Cargo.toml b/cli/Cargo.toml
index 3fcdfc0a8..8448cbe2c 100644
--- a/cli/Cargo.toml
+++ b/cli/Cargo.toml
@@ -2,7 +2,7 @@
 name = "usage-cli"
 edition = "2024"
 rust-version = "1.91"
-version = "7.0.2"
+version = "7.1.0"
 description = "CLI for working with usage-based CLIs"
 license = { workspace = true }
 authors = { workspace = true }
diff --git a/cli/usage.usage.kdl b/cli/usage.usage.kdl
index 3af8515b8..3c56d1d0b 100644
--- a/cli/usage.usage.kdl
+++ b/cli/usage.usage.kdl
@@ -2,7 +2,7 @@
 min_usage_version "6.5"
 name usage
 bin usage
-version "7.0.2"
+version "7.1.0"
 repository "https://github.com/jdx/usage"
 source_code_link_template #"""
 {%- set path = path | replace(from='-', to='_') -%}
diff --git a/config/Cargo.toml b/config/Cargo.toml
index 5aba5fc16..df7431a82 100644
--- a/config/Cargo.toml
+++ b/config/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-config"
 description = "Layered configuration resolution for usage specs, with provenance"
-version = "7.0.2"
+version = "7.1.0"
 edition = "2024"
 rust-version = "1.91"
 homepage = { workspace = true }
diff --git a/derive/Cargo.toml b/derive/Cargo.toml
index 85b14af36..351ba3f7f 100644
--- a/derive/Cargo.toml
+++ b/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 = "7.0.2"
+version = "7.1.0"
 edition = "2024"
 rust-version = "1.91"
 homepage = { workspace = true }
diff --git a/docs/cli/reference/commands.json b/docs/cli/reference/commands.json
index f09467cdb..1ca5ebe77 100644
--- a/docs/cli/reference/commands.json
+++ b/docs/cli/reference/commands.json
@@ -1980,7 +1980,7 @@
     "sources": {},
     "files": []
   },
-  "version": "7.0.2",
+  "version": "7.1.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}}",
diff --git a/docs/cli/reference/index.md b/docs/cli/reference/index.md
index c4d60d045..91c90eb0a 100644
--- a/docs/cli/reference/index.md
+++ b/docs/cli/reference/index.md
@@ -2,7 +2,7 @@
 
 # `usage`
 
-**Version:** 7.0.2
+**Version:** 7.1.0
 
 **Repository:** https://github.com/jdx/usage
 
diff --git a/lib/Cargo.toml b/lib/Cargo.toml
index b60f3a1cb..00976ebe3 100644
--- a/lib/Cargo.toml
+++ b/lib/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-lib"
 edition = "2024"
-version = "7.0.2"
+version = "7.1.0"
 rust-version = "1.91"
 include = [
     "/Cargo.toml",
diff --git a/test/Cargo.toml b/test/Cargo.toml
index d0206edf7..9e8fc149f 100644
--- a/test/Cargo.toml
+++ b/test/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-test"
 description = "Test helpers for CLIs built with usage"
-version = "7.0.2"
+version = "7.1.0"
 edition = "2024"
 rust-version = "1.91"
 homepage = { workspace = true }
diff --git a/usage-dynamic/Cargo.toml b/usage-dynamic/Cargo.toml
index 48ad64713..c34f59b09 100644
--- a/usage-dynamic/Cargo.toml
+++ b/usage-dynamic/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-dynamic"
 description = "Runtime command catalogs for usage-rs applications"
-version = "7.0.2"
+version = "7.1.0"
 edition = "2024"
 rust-version = "1.91"
 homepage = { workspace = true }
@@ -12,7 +12,7 @@ license = { workspace = true }
 
 [dependencies]
 usage-argv = { workspace = true, features = ["help-advanced", "spec", "complete"] }
-usage-parser = { package = "usage-lib", path = "../lib", version = "7.0.2", default-features = false, features = ["cli-help"] }
+usage-parser = { package = "usage-lib", path = "../lib", version = "7.1.0", default-features = false, features = ["cli-help"] }
 
 [package.metadata.release]
 shared-version = true
diff --git a/usage-rs/Cargo.toml b/usage-rs/Cargo.toml
index d1a6cd65f..00839ea26 100644
--- a/usage-rs/Cargo.toml
+++ b/usage-rs/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-rs"
 description = "A compiled CLI parser for Rust, built on usage specs"
-version = "7.0.2"
+version = "7.1.0"
 edition = "2024"
 rust-version = "1.91"
 homepage = { workspace = true }
diff --git a/usage-rs/tests/fixtures/runtime-identity/Cargo.lock b/usage-rs/tests/fixtures/runtime-identity/Cargo.lock
index 45de830e5..356ee134a 100644
--- a/usage-rs/tests/fixtures/runtime-identity/Cargo.lock
+++ b/usage-rs/tests/fixtures/runtime-identity/Cargo.lock
@@ -39,11 +39,11 @@ checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"
 
 [[package]]
 name = "usage-argv"
-version = "7.0.2"
+version = "7.1.0"
 
 [[package]]
 name = "usage-derive"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -52,7 +52,7 @@ dependencies = [
 
 [[package]]
 name = "usage-rs"
-version = "7.0.2"
+version = "7.1.0"
 dependencies = [
  "usage-argv",
  "usage-derive",
diff --git a/validation/Cargo.toml b/validation/Cargo.toml
index 1873145b6..c8f6e99f2 100644
--- a/validation/Cargo.toml
+++ b/validation/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-validation"
 description = "Portable expression validation for usage specs"
-version = "7.0.2"
+version = "7.1.0"
 edition = "2024"
 rust-version = "1.91"
 homepage = { workspace = true }