diff --git a/docs/releases/v0.13.0.md b/docs/releases/v0.13.0.md new file mode 100644 index 0000000..a4605d6 --- /dev/null +++ b/docs/releases/v0.13.0.md @@ -0,0 +1,64 @@ +# Weatherreporter v0.13.0 + +This release upgrades Weatherreporter's generated-text integration through +PromptKit v0.9.0 and adds bounded structured-output repair, inherited domain +profiles, safer provider diagnostics, and repair provenance. + +## Summary + +Weatherreporter now permits one PromptKit-owned corrective generation when a +model returns invalid or explicitly empty structured output. Successful and +failed results report the actual correction count when validation completed, +and explicit prompt-debug capture can retain bounded provider failure details +without exposing them in ordinary output. + +The stable `weather-light`, `weather-balanced`, and `weather-deep` profiles now +inherit their execution targets from PromptKit's maintained catalog. PromptKit +v0.9.0 assembles that catalog from independently versioned OpenRouter and +Rakestrawhome modules while preserving Weatherreporter's existing effective +profile targets and configured-profile override behavior. + +## Compatibility + +The documented CLI, configuration fields, report IDs, report filenames, +Markdown outputs, and Distributor integration remain compatible with v0.12.0. +The four generated-text prompts advance to version `2.1.0`; an eligible failed +validation may therefore make one additional provider call, increasing latency +and usage for that execution. + +Comparison bundles advance from schema v1 to v2 so each completed validation +can record `repairAttempts`. Weatherreporter intentionally recognizes only the +current bundle version for guarded replacement. An existing v1 comparison +bundle cannot be replaced with `--replace` by this release. + +## Upgrade + +No special action is required for ordinary generation, batch execution, +configuration, or notification. Operators who want to reuse the destination +of a v1 comparison bundle must first remove or relocate that old bundle, or +select a new `--out-dir`. + +Operators should account for the possibility of one additional model call +when output repair is needed. Existing configured standalone, inherited, and +endpoint-only profiles retain their documented precedence. + +## Changes + +- Upgraded PromptKit from v0.5.0 through v0.9.0 and adopted its maintained + profile inheritance, optional credential-source behavior, structured repair, + generation-error contract, and externally maintained provider catalogs. +- Converted the three Weatherreporter domain profiles into minimal aliases of + maintained PromptKit profiles without changing their effective model ladder. +- Added one corrective-generation allowance to all four embedded prompts and + exposed actual repair counts in generate, batch, and comparison summaries. +- Migrated the [comparison bundle contract](../integrations/comparison-bundle.md) + to v2 with strict repair-provenance validation and safe partial publication + after independent profile failures. +- Added safe provider HTTP status to ordinary errors while confining provider + code, type, and message to explicit secure `failure.json` debug artifacts. +- Strengthened offline coverage for local endpoint-only profiles, optional + credentials, concurrent comparison repair outcomes, and failure-debug + isolation. +- Updated the [PromptKit integration guide](../integrations/promptkit.md), + [configuration reference](../config.md), [CLI reference](../cli.md), and + [operations guide](../operations.md) for the implemented contracts.