From b57bfe176cff05a892e6cb07ebb5f350239e55d4 Mon Sep 17 00:00:00 2001 From: Eric Rakestraw Date: Tue, 17 Nov 2026 18:15:55 +0000 Subject: [PATCH] Prepare CommandKit v0.7.0 and record release coordination --- docs/consumers/guide.md | 21 +++++++------- docs/releases/v0.7.0.md | 29 +++++++++++++++++++ docs/roadmap/future.md | 8 +++++ integrations/ckprompt/docs/releases/v0.9.0.md | 14 ++++----- 4 files changed, 53 insertions(+), 19 deletions(-) create mode 100644 docs/releases/v0.7.0.md diff --git a/docs/consumers/guide.md b/docs/consumers/guide.md index d301c24..ce530b1 100644 --- a/docs/consumers/guide.md +++ b/docs/consumers/guide.md @@ -14,18 +14,19 @@ applications. | `go.maximumdirect.net/ckconfig` | You want operators to view, validate, explain, and compare ConfigKit configuration. | | `go.maximumdirect.net/ckprompt` | You want operators to inspect PromptKit resources, check and preview requests, or run smoke tests. | -The v0.8.0 integrations select ConfigKit v1.2.0, and ckprompt selects PromptKit -v0.21.0. +Published ckconfig v0.8.0 and ckprompt v0.9.0 select ConfigKit v1.2.0. +ckprompt v0.9.0 selects PromptKit v0.23.1. | Selection | Core | ckconfig | ckprompt | Upstream libraries and status | | --- | --- | --- | --- | --- | -| Published core | v0.6.0 | — | — | Usable independently. | +| Published core | v0.7.0 | — | — | Usable independently. | | ConfigKit integration | v0.6.0 | v0.8.0 | — | ConfigKit v1.2.0. | -| PromptKit integration | v0.6.0 | v0.8.0 | v0.8.0 | ConfigKit v1.2.0 and PromptKit v0.21.0. | +| PromptKit integration | v0.6.0 | v0.8.0 | v0.9.0 | ConfigKit v1.2.0 and PromptKit v0.23.1. | | Earlier matched integration set | v0.3.0 | v0.2.0 | v0.2.0 | ConfigKit v0.8.0 and PromptKit v0.16.0, using their earlier import paths. | -The prepared ckprompt v0.9.0 candidate selects core v0.6.0, ckconfig v0.8.0, -ConfigKit v1.2.1, and PromptKit v0.23.2. It is not yet published. +The current integration checkouts select ConfigKit v1.2.1 and PromptKit +v0.23.2. Their coordinated releases follow core under the +[release procedure](../release.md#scope-and-release-order). For applications moving from ckprompt v0.8.0, the [v0.9.0 upgrade notes](../../integrations/ckprompt/docs/releases/v0.9.0.md#compatibility-and-upgrade) cover migration of positional literals for affected native PromptKit structs. @@ -33,12 +34,12 @@ cover migration of positional literals for affected native PromptKit structs. Install the published core with: ```sh -go get go.maximumdirect.net/commandkit@v0.6.0 +go get go.maximumdirect.net/commandkit@v0.7.0 ``` Select either integration with `go get go.maximumdirect.net/ckconfig@v0.8.0` -or `go get go.maximumdirect.net/ckprompt@v0.8.0`. The published integrations -select core v0.6.0. ckprompt v0.8.0 selects ckconfig v0.8.0, which includes +or `go get go.maximumdirect.net/ckprompt@v0.9.0`. The published integrations +select core v0.6.0. ckprompt v0.9.0 selects ckconfig v0.8.0, which includes `AdaptDiagnostics` and `ClassifyConfigurationError`. Both integrations build independently against their released dependencies. An aligned workspace can exercise the local sources together during development. @@ -63,7 +64,7 @@ the `config` family. ## Go compatibility All three modules in the current checkout declare a consumer minimum of -Go 1.27.0. Published core v0.6.0 declares Go 1.26.0. The current root module +Go 1.27.0. Core v0.7.0 raises its minimum from v0.6.0's Go 1.26.0. The root module selects ReleaseKit v0.10.0 (`go.maximumdirect.net/releasekit`) as a Go tool, which makes that tool's module graph part of the root consumer module requirements even though production packages do not import ReleaseKit. ReleaseKit v0.10.0 diff --git a/docs/releases/v0.7.0.md b/docs/releases/v0.7.0.md new file mode 100644 index 0000000..2a8b059 --- /dev/null +++ b/docs/releases/v0.7.0.md @@ -0,0 +1,29 @@ +# CommandKit v0.7.0 + +CommandKit v0.7.0 refreshes the CLI, YAML, and maintainer-tool dependencies. + +## Dependency updates + +- Cobra v1.10.1 → v1.10.2 and pflag v1.0.9 → v1.1.0 update CLI parsing, + help, and diagnostics. Cobra also selects the maintained YAML v3 module path. +- go-yaml v4.0.0 replaces v4.0.0-rc.6 for report decoding and encoding. +- ReleaseKit v0.10.0 updates maintainer tooling and selects Goldmark v2.1.16 + and Go Modules v0.43.0. + +## Compatibility and upgrade + +The core consumer minimum increases from Go 1.26.0 to Go 1.27.0 because the +registered ReleaseKit tool now requires Go 1.27.0. Upgrade the Go toolchain +before selecting this release. Maintainer validation uses Go 1.27.4. + +Applications continue to use the existing CommandKit APIs and standard command +grammar. Review scripts that depend on exact backend diagnostic or help text +when adopting the parser updates. The current CLI and reporting contracts are +documented in the [CLI reference](../cli.md), and the +[consumer guide](../consumers/guide.md#module-selection) records module pairing. +Coordinated ckconfig and ckprompt releases follow this core release under the +[dependency-alignment policy](../policy/release.md#commandkit-downstream-dependency-alignment). + +[COPYRIGHT](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/v0.7.0/COPYRIGHT) | +[LICENSE](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/v0.7.0/LICENSE) | +[ATTRIBUTION](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/v0.7.0/docs/oss/attribution.md) diff --git a/docs/roadmap/future.md b/docs/roadmap/future.md index be40f24..23c1b67 100644 --- a/docs/roadmap/future.md +++ b/docs/roadmap/future.md @@ -37,6 +37,14 @@ govern any future implementation. The [CLI reference](../cli.md), public GoDoc, and [consumer guide](../consumers/guide.md) own implemented behavior. Retaining an idea here does not select its syntax, API, priority, or delivery date. +## Release coordination + +Core v0.7.0 initiates the dependency refresh. Publish ckconfig v0.9.0 with +core v0.7.0, then ckprompt v0.10.0 with both published dependencies. Prepare +each integration after its dependencies are published, following the +[release procedure](../release.md#scope-and-release-order). Hosted pages follow +each module's source publication. Remove this item when coordination is complete. + ## Optional verification ### Optional shell completion validation diff --git a/integrations/ckprompt/docs/releases/v0.9.0.md b/integrations/ckprompt/docs/releases/v0.9.0.md index 062e6b8..bb38fc5 100644 --- a/integrations/ckprompt/docs/releases/v0.9.0.md +++ b/integrations/ckprompt/docs/releases/v0.9.0.md @@ -1,6 +1,6 @@ # CommandKit ckprompt v0.9.0 -This candidate upgrades PromptKit from v0.21.0 to v0.23.2. PromptKit's +This candidate upgrades PromptKit from v0.21.0 to v0.23.1. PromptKit's constructor now preserves configuration causes without treating its category sentinel as a separate failure. @@ -13,23 +13,19 @@ source and validation reports, diagnostics, typed ConfigKit causes, and cancellation continue to select status `1`. See the [configuration failure contract](../../../../docs/cli.md#configuration-failure-classification). -The current candidate selects stable go-yaml v4.0.0, jsonschema v6.0.3, and -Go Text v0.44.0 through its updated dependencies. Validator fixes can affect -edge-case results and diagnostic locations. - Pair ckprompt v0.9.0 with ckconfig v0.8.0 and CommandKit core v0.6.0. The -selected upstream versions are ConfigKit v1.2.1 and PromptKit v0.23.2; the Go +selected upstream versions are ConfigKit v1.2.0 and PromptKit v0.23.1; the Go consumer minimum remains 1.27.0. Native request builders continue to pass the whole PromptKit request, including additive fields, and prepared reports carry upstream fields such as parent run identifiers. Applications own construction of engines and requests. See the [consumer guide](../../../../docs/consumers/guide.md#promptkit-configuration-definitions-and-requirements) -and [upstream upgrade guidance](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/382ccfb14b9630fd8f48c8364dbe2b6159637d71/docs/releases/v0.23.2.md#compatibility-and-upgrade). +and [upstream upgrade guidance](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/74066167942fcf6f70c112359995739ec9789fa6/docs/releases/v0.23.1.md#compatibility-and-upgrade). PromptKit v0.22.0 and v0.23.0 added fields to exported request, prepared, result, and observation structs. If your application constructs affected types with positional literals, migrate those literals to keyed fields when upgrading -from v0.21.0. See [PromptKit v0.22.0 compatibility](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/382ccfb14b9630fd8f48c8364dbe2b6159637d71/docs/releases/v0.22.0.md#efficiency-and-compatibility) -and [PromptKit v0.23.0 upgrade guidance](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/382ccfb14b9630fd8f48c8364dbe2b6159637d71/docs/releases/v0.23.0.md#compatibility-and-upgrade). +from v0.21.0. See [PromptKit v0.22.0 compatibility](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/74066167942fcf6f70c112359995739ec9789fa6/docs/releases/v0.22.0.md#efficiency-and-compatibility) +and [PromptKit v0.23.0 upgrade guidance](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/74066167942fcf6f70c112359995739ec9789fa6/docs/releases/v0.23.0.md#compatibility-and-upgrade). [COPYRIGHT](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/integrations/ckprompt/v0.9.0/integrations/ckprompt/COPYRIGHT) | [LICENSE](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/integrations/ckprompt/v0.9.0/integrations/ckprompt/LICENSE) |