chore: release v0.3.1

CHANGELOG.md

@@ -1,13 +1,27 @@
 # Changelog
 
-## Unreleased (draft vs v0.3.0)
+## 0.3.1 - 2026-09-06
 
 <!-- soothfast:notes -->
-<!-- ### Overview -->
-<!-- What this release means for someone using it. One paragraph. -->
+### Overview
+
+A follow-up to 0.3.0 for repositories whose layout the one-step action could
+not yet run as declared. The action now passes Cargo features through to the
+gate, the baseline measurement, and spec generation, with a separate feature
+set for the changelog's API surface; it can diff the changelog over crates
+that have no bench target; and `regen-run` lands any other derived file (an
+SDK, a rendered report) through the same bot pull request. The broker now
+judges an annotated tag by the commit under it, so a release from such a tag
+cannot fail on the tag object.
+
+### Upgrade notes
 
-<!-- ### Upgrade notes -->
-<!-- What a consumer has to do. "Nothing" is a useful answer. -->
+Nothing changes for a job that already runs 0.3.0. A bench target that
+declares `required-features` needs `features:` on the step; a crate with an
+API but no bench needs `changelog-packages:`; a repository whose derived
+files come from `sdk gen` or a custom command moves that command into
+`regen-run:` with its output paths in `regen-paths:`, both required
+together. See `docs/ci.md` for the input table.
 <!-- /soothfast:notes -->
 
 ### ✨ Features
@@ -24,7 +38,7 @@
 <!-- soothfast:notes -->
 ### Overview
 
-soothfast now installs into another repository the way codecov does: one
+soothfast now installs into another repository with one
 `uses: Verdenroz/soothfast@v0.3.0` step in an existing workflow, the
 Soothfast Bot GitHub App installed once, and no secrets. On pull requests the
 step gates every bench-carrying package against the base branch and posts the

Cargo.toml

@@ -14,7 +14,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.3.0"
+version = "0.3.1"
 edition = "2024"
 rust-version = "1.88"
 license = "MIT"
@@ -26,14 +26,14 @@ categories = ["development-tools", "development-tools::profiling", "development-
 
 [workspace.dependencies]
 # `version` alongside `path` lets `cargo publish` resolve intra-workspace deps.
-soothfast-macros = { path = "soothfast-macros", version = "0.3.0" }
-soothfast-registry = { path = "soothfast-registry", version = "0.3.0" }
-soothfast-measure = { path = "soothfast-measure", version = "0.3.0" }
-soothfast-docs = { path = "soothfast-docs", version = "0.3.0" }
-soothfast-spec = { path = "soothfast-spec", version = "0.3.0" }
-soothfast-sdk = { path = "soothfast-sdk", version = "0.3.0" }
-soothfast-report = { path = "soothfast-report", version = "0.3.0" }
-soothfast-site = { path = "soothfast-site", version = "0.3.0" }
+soothfast-macros = { path = "soothfast-macros", version = "0.3.1" }
+soothfast-registry = { path = "soothfast-registry", version = "0.3.1" }
+soothfast-measure = { path = "soothfast-measure", version = "0.3.1" }
+soothfast-docs = { path = "soothfast-docs", version = "0.3.1" }
+soothfast-spec = { path = "soothfast-spec", version = "0.3.1" }
+soothfast-sdk = { path = "soothfast-sdk", version = "0.3.1" }
+soothfast-report = { path = "soothfast-report", version = "0.3.1" }
+soothfast-site = { path = "soothfast-site", version = "0.3.1" }
 serde_json = "1"
 linkme = "=0.3.37"
 proc-macro2 = "1"

README.md

@@ -75,7 +75,7 @@ covered in the **[full guide](https://verdenroz.github.io/soothfast/)**.
 
 ```toml
 [dev-dependencies]
-soothfast = { version = "0.3.0", features = ["runner"] }
+soothfast = { version = "0.3.1", features = ["runner"] }
 
 [[bench]]
 name = "soothfast"

docs/spec.md

@@ -309,7 +309,7 @@ adjustable per `[[spec]]` entry:
 path = "openapi.yaml"
 mode = "generate"
 workspace_types = true               # the default; false reports gaps instead
-workspace_crates = ["finance-query"] # default: every workspace dep of the package
+workspace_crates = ["mylib-core"] # default: every workspace dep of the package
 ```
 
 A crate that fails to document warns and is skipped, leaving its types to

soothfast.toml

@@ -4,7 +4,7 @@
 
 [site]
 name = "soothfast"
-version = "0.3.0"
+version = "0.3.1"
 repo = "https://github.com/Verdenroz/soothfast"
 
 [[site.nav]]