Skip to content

Commit c509bf9

Browse files
authored
docs: add missing Platform changelog and fix workflow for server repo (#198)
1 parent 3131ad9 commit c509bf9

2 files changed

Lines changed: 32 additions & 3 deletions

File tree

.mintlify/workflows/update-changelog.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,16 @@ notify:
1414

1515
# Agent Instructions
1616

17-
Check each repository (kosli-dev/cli, kosli-dev/terraform-provider-kosli, kosli-dev/server) for **new tags/releases** published since the last changelog entry for that product in changelog/index.mdx. Only document changes that are part of a tagged release — do not include unreleased work on `main`.
17+
Check each repository for **new tags** published since the last changelog entry for that product in changelog/index.mdx. Only document changes that are part of a tagged release — do not include unreleased work on `main`.
1818

19-
For each new release tag found, write a changelog entry in changelog/index.mdx. If no new tags exist for a repository since its last changelog entry, skip it. If there are no new tags across any repository, do not open a PR.
19+
- **kosli-dev/cli** and **kosli-dev/terraform-provider-kosli** use semver GitHub Releases (e.g., `v2.17.5`, `v0.6.3`). Check the Releases list for new versions.
20+
- **kosli-dev/server** does **not** use GitHub Releases. It uses timestamp-based git tags (e.g., `release-2026-04-30-10-56-05`). You must check git **tags** (not Releases) and look at the commits between the last covered tag and the most recent tag to identify user-facing changes. Consolidate all server changes since the last Platform changelog entry into a single entry.
21+
22+
For each new release found, write a changelog entry in changelog/index.mdx. If no new tags exist for a repository since its last changelog entry, skip it. If there are no new tags across any repository, do not open a PR.
2023

2124
This workflow only updates changelog/index.mdx. Do not modify any other files.
2225

23-
Label should be the date the workflow runs, like "March 16, 2026". Description should be the version number of the release, like "v0.3.0".
26+
Label should be the date the workflow runs, like "March 16, 2026". Description should be the version number of the release for semver repositories (e.g., "v0.3.0"). For kosli-dev/server, leave description empty (`""`) since it has no semver version.
2427
Tags should be the product(s) affected by the release:
2528
- kosli-dev/cli → `["CLI"]`
2629
- kosli-dev/terraform-provider-kosli → `["Terraform Provider"]`

changelog/index.mdx

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,32 @@ description: "Release notes for Kosli products."
44
rss: true
55
---
66

7+
<Update label="May 4, 2026" description="" tags={["Platform"]}>
8+
9+
## New features
10+
11+
- **PATCH endpoint for environment updates** — a new `PATCH /environments/{org}/{env_name}` endpoint allows updating individual environment fields without replacing the entire resource. This fixes the issue where setting a description to an empty string was silently ignored, and enables proper support in the [Terraform provider](/terraform-reference/resources/environment).
12+
13+
## Updates
14+
15+
- **Significantly faster environment and snapshot pages** — eliminated thousands of redundant database queries during snapshot reporting and page rendering. For large environments (~800 artifacts), this removes approximately 5,600 unnecessary database round-trips per snapshot report. The environment events page, which previously took ~60 seconds to load for large environments, now loads normally.
16+
- **Infinite scroll on snapshot events tab** — the snapshot events tab now loads events incrementally via infinite scroll instead of all at once, improving responsiveness for environments with many events.
17+
- **Improved environment page search** — search and filter on the environment page now returns all matching artifacts in a single request with loading indicators, fixing broken behavior for large environments.
18+
- **Faster flow filter lookups** — environment pages that filter by flow now use a pre-materialized collection instead of scanning all artifacts, speeding up load times.
19+
- **Case-insensitive email lookups** — user and invitation email lookups no longer require exact case matching.
20+
- **Redirect preserved through login** — when a session expires, the original destination URL (e.g., an org invite page) is now preserved through the logout/login cycle.
21+
- **API documentation improvements** — the OpenAPI spec title is now "Kosli API", endpoints are sorted alphabetically, and server URLs are absolute for [API playground](/api-reference) compatibility.
22+
23+
## Bug fixes
24+
25+
- Fixed the flows filter incorrectly rejecting substring searches starting with hyphens, underscores, dots, or tildes.
26+
- Fixed the logical environment snapshot events tab raising an error, and the "Running" badge incorrectly counting exited artifacts.
27+
- Fixed a 500 error when listing API keys with legacy expiration timestamps.
28+
- Fixed unhandled exceptions during OAuth and SSO sign-in flows.
29+
- Security: upgraded xz/xz-libs packages to patch CVE-2026-34743.
30+
31+
</Update>
32+
733
<Update label="May 4, 2026" description="v2.17.5" tags={["CLI"]}>
834

935
## Updates

0 commit comments

Comments
 (0)