Document Weatherreporter v0.13.0

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.