docs: add changelog entries on CLI and Platform releases

[mintlify]

Summary

Documents CLI releases v2.28.1 and v2.28.2 and five Platform releases shipped between 2026-06-22 and 2026-06-26.

Changes

• CLI v2.28.1 (June 22) — ECS snapshot fix for empty clusters; beta status moved off short descriptions.
• CLI v2.28.2 (June 24) — dependency updates.
• Platform (June 23) — decision attestation in flow templates; "+ Add tag" affordance; expat security upgrade.
• Platform (June 24) — archive/unarchive controls; controls coverage report; filter decisions by flow; Controls API in OpenAPI (beta); CSRF skip with Authorization header; experimental-features opt-in removed; SSRF fix in webhook actions; control-link dot sanitization.
• Platform (June 25) — deployment lead_time_seconds; require shared orgs archived before org delete; faster /organizations/shared.
• Platform (June 26) — faster initiate-delete with improved UI feedback; lifecycle status on control Version List; card-list UI for Controls Decision/Version lists.

No new tags for kosli-dev/terraform-provider-kosli in the scope window.

[claude]

Claude finished @dangrondahl's task in 2m 8s —— View job

---

Review of PR #292

• Read changed file and gather context
• Review content against CLAUDE.md conventions
• Check for style, spelling, and link issues
• Post review findings

---

Overall: This PR is in good shape after the latest refinement commit (ca731c0). The changelog entries are well-structured, follow existing conventions, and read clearly.

Findings

Previously flagged — now resolved:

• The British spelling "catalogue" → "catalog" from the earlier review has been fixed. No British spellings remain.

No issues found in:

• Links — all external, absolute (GitHub release links). No relative links. ✓
• <Update> component format — consistent with existing entries (full date labels, version in description for CLI, empty for Platform). ✓
• Navigation — no new pages added, so no config/navigation.json update needed. ✓
• Writing style — active voice, em-dash separators, sentence case headings, consistent with prior entries. ✓
• Front matter — unchanged. ✓

Suggestion (editorial):

• The June 25 Platform entry has a single bullet (deployment lead_time_seconds). The PR description originally listed two more items ("require shared orgs archived before org delete", "faster /organizations/shared"). If those were intentionally trimmed as too backend-facing, that's fine — just noting the delta for the author's awareness.
• Similarly, "faster initiate-delete with improved UI feedback" was trimmed from June 26. The two items that remain (lifecycle status, card-list UI) are the more user-visible ones, so the trim seems reasonable.

Follow-up (already tracked):

• @dangrondahl's comments about updating flow template docs to reflect the new decision attestation type are tracked in Generate flow-template and policy JSON schemas from the API (source of truth) #293 and Update flow_template reference page: add 'decision' attestation type #294 — no action needed in this PR.

Looks good to merge once the author confirms the trimmed items were intentional.

[dangrondahl]

If this is a field in the flow template now, we should update documentation accordingly.
For example here https://docs.kosli.com/template-reference/flow_template

[dangrondahl]

Generally, since schemas now have an API endpoint, for example: /schemas/flow-template/v1 the static docs schemas should be generated from the API as this is the source of truth.
Same goes for environment policies /schemas/environment-policy/v1

[dangrondahl]

Created issues:

• Generate flow-template and policy JSON schemas from the API (source of truth) #293
• Update flow_template reference page: add 'decision' attestation type #294

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
kosli	🟢 Ready	View Preview	Jun 29, 2026, 9:27 AM