Prepare CommandKit v0.7.0 and record release coordination
This commit is contained in:
@@ -14,18 +14,19 @@ applications.
|
|||||||
| `go.maximumdirect.net/ckconfig` | You want operators to view, validate, explain, and compare ConfigKit configuration. |
|
| `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. |
|
| `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
|
Published ckconfig v0.8.0 and ckprompt v0.9.0 select ConfigKit v1.2.0.
|
||||||
v0.21.0.
|
ckprompt v0.9.0 selects PromptKit v0.23.1.
|
||||||
|
|
||||||
| Selection | Core | ckconfig | ckprompt | Upstream libraries and status |
|
| 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. |
|
| 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. |
|
| 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,
|
The current integration checkouts select ConfigKit v1.2.1 and PromptKit
|
||||||
ConfigKit v1.2.1, and PromptKit v0.23.2. It is not yet published.
|
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
|
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)
|
[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.
|
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:
|
Install the published core with:
|
||||||
|
|
||||||
```sh
|
```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`
|
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
|
or `go get go.maximumdirect.net/ckprompt@v0.9.0`. The published integrations
|
||||||
select core v0.6.0. ckprompt v0.8.0 selects ckconfig v0.8.0, which includes
|
select core v0.6.0. ckprompt v0.9.0 selects ckconfig v0.8.0, which includes
|
||||||
`AdaptDiagnostics` and `ClassifyConfigurationError`. Both integrations build
|
`AdaptDiagnostics` and `ClassifyConfigurationError`. Both integrations build
|
||||||
independently against their released dependencies. An aligned workspace can
|
independently against their released dependencies. An aligned workspace can
|
||||||
exercise the local sources together during development.
|
exercise the local sources together during development.
|
||||||
@@ -63,7 +64,7 @@ the `config` family.
|
|||||||
## Go compatibility
|
## Go compatibility
|
||||||
|
|
||||||
All three modules in the current checkout declare a consumer minimum of
|
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
|
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
|
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
|
even though production packages do not import ReleaseKit. ReleaseKit v0.10.0
|
||||||
|
|||||||
29
docs/releases/v0.7.0.md
Normal file
29
docs/releases/v0.7.0.md
Normal file
@@ -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)
|
||||||
@@ -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
|
and [consumer guide](../consumers/guide.md) own implemented behavior. Retaining
|
||||||
an idea here does not select its syntax, API, priority, or delivery date.
|
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 verification
|
||||||
|
|
||||||
### Optional shell completion validation
|
### Optional shell completion validation
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# CommandKit ckprompt v0.9.0
|
# 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
|
constructor now preserves configuration causes without treating its category
|
||||||
sentinel as a separate failure.
|
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
|
cancellation continue to select status `1`. See the [configuration failure
|
||||||
contract](../../../../docs/cli.md#configuration-failure-classification).
|
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
|
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
|
consumer minimum remains 1.27.0. Native request builders continue to pass the
|
||||||
whole PromptKit request, including additive fields, and prepared reports carry
|
whole PromptKit request, including additive fields, and prepared reports carry
|
||||||
upstream fields such as parent run identifiers. Applications own construction
|
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)
|
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,
|
PromptKit v0.22.0 and v0.23.0 added fields to exported request, prepared,
|
||||||
result, and observation structs. If your application constructs affected types
|
result, and observation structs. If your application constructs affected types
|
||||||
with positional literals, migrate those literals to keyed fields when upgrading
|
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)
|
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/382ccfb14b9630fd8f48c8364dbe2b6159637d71/docs/releases/v0.23.0.md#compatibility-and-upgrade).
|
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) |
|
[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) |
|
[LICENSE](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/integrations/ckprompt/v0.9.0/integrations/ckprompt/LICENSE) |
|
||||||
|
|||||||
Reference in New Issue
Block a user