Refresh dependency setup guidance and release v0.3.8.

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "socketry-project"
-version = "0.3.7"
+version = "0.3.8"
 edition = "2024"
 license = "MIT"
 repository = "https://github.com/socketry/socketry-project-rust"
@@ -23,11 +23,11 @@ name = "socketry_project"
 
 [dependencies]
 bake = ">=0.19.0"
-bake-agent-context = { version = ">=0.2.0" }
+bake-agent-context = { version = ">=0.3.2" }
 bake-cargo = { version = ">=0.4.0" }
 bake-license = { version = ">=0.1.1" }
 bake-markdown = { version = ">=0.3.0" }
-bake-readme = { version = ">=0.1.1" }
+bake-readme = { version = ">=0.2.3" }
 bake-releases = { version = ">=0.2.1" }
 bake-test-rust = { version = ">=0.3.0" }
 

bake/Cargo.toml

@@ -7,4 +7,4 @@ publish = false
 [dependencies]
 bake = "0.19.0"
 bake-markdown = "0.3.0"
-socketry-project = { path = "..", version = "0.3.7" }
+socketry-project = { path = "..", version = "0.3.8" }

context/setup.md

@@ -24,12 +24,14 @@ cargo install socketry-cargo-bake --locked
 cargo bake --regenerate
 ```
 
-The command creates `bake/`, adds it to the Cargo workspace, and writes a minimal binary. Add this dependency under the existing `[dependencies]` table in `bake/Cargo.toml`:
+The command creates `bake/`, adds it to the Cargo workspace, and writes a minimal binary. Let Cargo select the current dependency version:
 
-```toml
-socketry-project = ">=0.3.6"
+```sh
+cargo add --manifest-path bake/Cargo.toml socketry-project
 ```
 
+In `bake/Cargo.toml`, prefix the version selected by Cargo with `>=` to make it an open-ended minimum. Keep that actual minimum in the manifest and the resolved version in `Cargo.lock`; the setup documentation does not need a copy of either version.
+
 The open-ended minimum requirement allows newer `socketry-project` releases. The private Bake package's `Cargo.lock` records the selected version, so update the lockfile deliberately when adopting a newer release.
 
 Run regeneration again to link its task registrations:

readme.md

@@ -15,12 +15,14 @@ cargo install socketry-cargo-bake --locked
 cargo bake --regenerate
 ```
 
-Add this dependency under the existing `[dependencies]` table in `bake/Cargo.toml`:
+Let Cargo select the current dependency version:
 
-```toml
-socketry-project = ">=0.3.7"
+```sh
+cargo add --manifest-path bake/Cargo.toml socketry-project
 ```
 
+In `bake/Cargo.toml`, prefix the version selected by Cargo with `>=` to make it an open-ended minimum. Keep that actual minimum in the manifest and the resolved version in `Cargo.lock`; the setup documentation does not need a copy of either version.
+
 Then run `cargo bake --regenerate` again to link the dependency's tasks. The command keeps generated links separate from task source, so no manual import in `main.rs` is needed. Run `cargo bake --list` to see the available tasks. The open-ended minimum requirement keeps this development dependency eligible for newer releases. `Cargo.lock` records the selected version for reproducible builds; update it deliberately when adopting a newer release.
 
 This adds the standard Cargo, release, license, Readme, Markdown, agent-context, and testing tasks, including `test` and `test:external`. It also registers a version-bump hook that updates the project's standard files.
@@ -37,6 +39,11 @@ Prepare a release with `cargo bake cargo:version:patch` (or `minor`, `major`, or
 
 See [releases.md](releases.md) for the full release history.
 
+### v0.3.8
+
+- Let Cargo select setup dependency versions while retaining open-ended minimum requirements.
+- Require current agent-context and readme providers so installed guidance preserves repository instructions and shared conventions.
+
 ### v0.3.7
 
 - Require a stable aggregate test and coverage result alongside publishing checks.
@@ -48,11 +55,12 @@ See [releases.md](releases.md) for the full release history.
 - Fix the version bump hook's invocation of the Markdown normalizer.
 - Include `bake-markdown` 0.3.0 in the shared task set so version bumps use hyphen markers for unordered lists.
 
-### v0.3.5
+<!-- bake-readme:releases:end -->
 
-- Require `bake-test-rust` 0.3.0 or newer for LLVM region coverage and update the shared testing guidance to match.
+## See Also
 
-<!-- bake-readme:releases:end -->
+- [`bake`](https://github.com/socketry/bake-rust).
+- [`bake-test-rust`](https://github.com/socketry/bake-test-rust).
 
 ## Contributing
 

releases.md

@@ -1,5 +1,10 @@
 # Releases
 
+## v0.3.8
+
+- Let Cargo select setup dependency versions while retaining open-ended minimum requirements.
+- Require current agent-context and readme providers so installed guidance preserves repository instructions and shared conventions.
+
 ## v0.3.7
 
 - Require a stable aggregate test and coverage result alongside publishing checks.