From c88d4b4041f1f637f28b70b7e4bbc8696b7dbe4d Mon Sep 17 00:00:00 2001 From: Jon Langevin Date: Tue, 28 Apr 2026 00:43:03 -0400 Subject: [PATCH] docs(changelog): add v0.8.0 legacy-compat note + filed follow-up MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per release-task spec from team-lead: documents the plugin dispatch mode this release ships under (workflow's legacy untyped map[string]any + structpb), explains why the F7 canonical-shape Outputs use is a stopgap, and pins migration to strict typed-contract dispatch (workflow v0.19.0-alpha.5+) for v0.9.0. Filed follow-up: #37 — ref.Name vs spec.Name in FirewallDriver.Update error formatting (Minor advisory from F7 review, non-blocking, scoped for v0.8.x). Doc-only change. No code touched. Lands on top of v0.8.0 release commit (#38) before the v0.8.0 tag is pushed so the tag's CHANGELOG entry includes the note. Co-authored-by: Claude --- CHANGELOG.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 97928bb..5feb63b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -119,6 +119,22 @@ fixtures from workflow v0.20.1. start ensures `Diff` reads symmetric values whether `current.Outputs` is consumed in-process or after a structpb round-trip. +### Notes + +- **Plugin dispatch mode: legacy compat.** This release ships under + workflow's legacy plugin dispatch (untyped `map[string]any` arguments + transported via `structpb`). The F7 firewall Diff fix uses + canonical-shape Outputs (typed values converted to structpb-compatible + `[]any` of primitive/map shapes) as a stopgap to survive the gRPC + structpb boundary. Migration to workflow's strict typed-contract + dispatch (`v0.19.0-alpha.5+`) is scoped for v0.9.0. Once strict-mode + is enabled, the canonical-shape conversion becomes obsolete and + Outputs writers + Diff readers will use generated proto types + end-to-end. +- **Filed follow-up:** issue #37 — use `ref.Name` consistently for + `FirewallDriver.Update` error formatting (Minor advisory from F7 + review; non-blocking, scoped for v0.8.x). + ## [v0.7.9] - 2026-04-24 ### Added