diff --git a/docs/releases/v0.14.0.md b/docs/releases/v0.14.0.md new file mode 100644 index 0000000..2f97b2f --- /dev/null +++ b/docs/releases/v0.14.0.md @@ -0,0 +1,48 @@ +# Promptkit v0.14.0 + +This release adds comparison of captured configuration inspections and updates +ConfigKit and the maintainer release tool. The minimum supported Go version +remains 1.26.0. + +## Compare Captured Configurations + +`ConfigurationInspection.Diff` compares the effective configuration captured by +two engines. Consumers can use it to review a candidate configuration, inspect +an overlay's effect, or present configuration changes to operators. + +Comparison delegates to ConfigKit and returns its difference records, including +presence information, paired redaction, and protected-change indicators. It +does not reload sources or contact providers. Source-history differences alone +do not produce value differences. + +An empty diff is not proof of equivalent execution: referenced file contents, +resolved credentials, later execution preparation, and request-specific +overrides are outside the comparison. Records can contain ordinary application +data; callers retain responsibility for their disclosure. + +See the [configuration comparison guide](../consumers/pkg-promptkit.md#inspect-the-captured-configuration) +and [GoDoc](../../configuration_inspection.go) for usage and the exact contract. + +## Dependency And Tooling Updates + +- Upgrade ConfigKit from v0.6.0 to v0.7.1, providing the upstream comparison API. + v0.7.1 also updates ConfigKit's maintainer tooling without changing its runtime + behavior from v0.7.0. +- Upgrade the module-selected ReleaseKit tool from v0.3.0 to v0.4.1. Promptkit + retains its existing root-module profile, publication entry point, and release + gates. See the [release procedure](../release.md) for maintainer commands. + +## Compatibility And Upgrade + +No application-code, configuration, or Go-toolchain migration is required from +v0.13.0. Configuration comparison is an optional API addition; existing +construction, inspection, preparation, and execution workflows remain available. + +```sh +go get gitea.maximumdirect.net/eric/promptkit@v0.14.0 +``` + +See [Go compatibility](../consumers/pkg-promptkit.md#go-compatibility) for the +distinction between the consumer minimum and maintainer toolchain. + +[COPYRIGHT](https://gitea.maximumdirect.net/eric/promptkit/src/tag/v0.14.0/COPYRIGHT) | [LICENSE](https://gitea.maximumdirect.net/eric/promptkit/src/tag/v0.14.0/LICENSE) | [ATTRIBUTION](https://gitea.maximumdirect.net/eric/promptkit/src/tag/v0.14.0/docs/oss/attribution.md)