Skip to content

chore: update changelog CLI v2.39.0/v2.39.1 and Platform updates - #376

Merged
dangrondahl merged 5 commits into
mainfrom
mintlify/9cee9f39
Sep 7, 2026
Merged

chore: update changelog CLI v2.39.0/v2.39.1 and Platform updates#376
dangrondahl merged 5 commits into
mainfrom
mintlify/9cee9f39

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds changelog entries for releases published Aug 24–31: CLI v2.39.0 and v2.39.1, plus Platform changes shipped from the server.

Changes

  • CLI v2.39.0 (Aug 29): --sonar-branch flag, clearer Jira credential handling, --jira-project-key whitespace tolerance, .kosli_ignore help text.
  • CLI v2.39.1 (Aug 30): help text wording improvements.
  • Platform: SCIM user management handed to the IdP, Spaces enabled for every org, policy-expression missing-value fix, override attestations visible to environment policies, plus UI fixes (attestations infinite scroll, Spaces tree, Environments tag filter, magic links, flows list timestamps).
  • No new Terraform Provider release since v0.9.3, so no entry added.

@mintlify
mintlify Bot requested a review from a team as a code owner August 31, 2026 09:12
@mintlify

mintlify Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
kosli 🟢 Ready View Preview Aug 31, 2026, 9:13 AM

@claude

claude Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Claude finished @dangrondahl's task in 1m 58s —— View job


Doc review

  • Read both changed files at branch head (9962aa1)
  • Cross-check CLI claims against generated client_reference/ pages
  • Cross-check policy claims against policy-reference/
  • Sweep for stale Spaces enablement text
  • Verify links and <Update> format consistency
  • Post findings

No findings clear the bar on this push. The three rounds of feedback on this PR are resolved at head: the SCIM entries are gone (only the pre-existing SCIM sync mention at changelog/index.mdx:537 remains, untouched by this PR), the Aug 28 bullet links the tutorial, and tutorials/organizing_with_spaces.mdx no longer instructs readers to enable Spaces in org settings.

Cross-file checks that mattered here, and what they returned:

  • --sonar-branchclient_reference/kosli_attest_sonar.md:80 documents the flag with the same --pull-request mutual exclusion the entry claims, and :165 shows it in an example. Consistent.
  • --jira-project-key comma-separated listsclient_reference/kosli_attest_jira.md:96 ("Can be repeated, or given as a comma-separated list"). Consistent.
  • .kosli_ignore in command helpgrep -L kosli_ignore over every client_reference/kosli_attest_*.md plus kosli_allow_artifact.md and kosli_assert_artifact.md returns nothing, so the "every kosli attest command" claim holds at head.
  • "formatting glitches in the generated CLI reference" (v2.39.1) — no stray ^ (the CLI's backtick escape) on any page in client_reference/; the five remaining hits are legitimate regex anchors in kosli_snapshot_ecs.md / kosli_snapshot_lambda.md. The fix landed.
  • Stale-prerequisite sweepgrep -i for enable Spaces / feature flag / Spaces-plus-settings across all .md/.mdx returns only the changelog bullet itself and the unrelated LaunchDarkly page. Nothing else on the site still assumes the removed opt-in.
  • Links — all five internal links in the new entries are root-relative and resolve: the three client_reference/ pages, /tutorials/organizing_with_spaces, and /policy-reference/environment_policy#policy-expressions (anchor at policy-reference/environment_policy.mdx:93).
  • <Update> shapelabel / description / tags match the file's convention, including empty description="" for Platform entries; the ## New features / ## Updates / ## Bug fixes headings and the descending date order are consistent with the surrounding entries.

The two reference-page gaps agreed as follow-up work — missing-operand semantics and override handling in policy-reference/environment_policy.mdx — are not re-reported here.

One caveat on rule 5: mint is not installed in this runner (which mint → not found), so I verified link targets and anchors by reading the destination files rather than by running mint broken-links.
· branch mintlify/9cee9f39

Comment thread changelog/index.mdx Outdated
Comment thread changelog/index.mdx Outdated
Comment thread changelog/index.mdx Outdated
Comment thread changelog/index.mdx Outdated
Comment thread changelog/index.mdx Outdated
Comment thread changelog/index.mdx Outdated
@mbevc1 mbevc1 changed the title Update changelog: CLI v2.39.0/v2.39.1 and Platform updates chore: Update changelog CLI v2.39.0/v2.39.1 and Platform updates Aug 31, 2026
@mbevc1 mbevc1 changed the title chore: Update changelog CLI v2.39.0/v2.39.1 and Platform updates chore: update changelog CLI v2.39.0/v2.39.1 and Platform updates Aug 31, 2026
mintlify Bot and others added 3 commits September 7, 2026 08:35
- Move the SCIM user-management bullet under "Breaking changes": it removes
  a capability from the UI for affected admins.
- Split the opt-in toggle detail into its own "Updates" bullet, shortening the
  longest bullet in the file.
- Capitalize "Audit Log" as the page name instead of generic "audit log".
- Fix British "serialised" -> "serialized".
Comment thread changelog/index.mdx Outdated
Comment thread changelog/index.mdx
The August 28 changelog entry announces that the org-level opt-in setting
for Spaces is gone, but the tutorial still listed enabling it as step 3 --
a dead prerequisite that would make a reader conclude Spaces is unavailable.

- Remove the step and renumber.
- Drop the "Currently" hedge on availability, which described the gated state.
- Link the tutorial from the changelog bullet.
Comment thread changelog/index.mdx Outdated
Comment thread changelog/index.mdx
Comment thread changelog/index.mdx Outdated
Comment thread changelog/index.mdx Outdated
SCIM has no dedicated documentation page, so per review these entries have
nowhere to send a reader and should not ship until that page exists. The
work is tracked separately.
@dangrondahl
dangrondahl merged commit b72d1fe into main Sep 7, 2026
6 checks passed
@dangrondahl
dangrondahl deleted the mintlify/9cee9f39 branch September 7, 2026 09:21
dangrondahl added a commit that referenced this pull request Sep 7, 2026
## Summary

Adds the changelog entry for CLI **v2.39.2**, plus the Docker image
version fix from v2.39.0 that was missing.

Rebased on `main` after #376 merged. #376 had already documented v2.39.0
and v2.39.1, so this PR is now purely additive — no deletions.

## Conflict resolution

Four conflicts in `changelog/index.mdx`, resolved as follows:

- **v2.39.2** — new, kept as generated. Placed above the August 31
Platform entry, keeping the file newest-first.
- **v2.39.0 and v2.39.1 prose** — kept the versions already on `main`
from #376 and discarded this branch's rewordings, since they had been
through review and use the correct command name (see below).
- **The August 24–28 Platform entries** — kept `main`'s; this branch
predated them.

## The Docker version fix

This branch carried a Docker version bullet on both v2.39.0 and v2.39.1,
and `main` had neither. Checking upstream, only one of them is a
user-facing fix:

- **v2.39.0** ([cli#1137](kosli-dev/cli#1137)) —
the real fix. Published images identified themselves as `dev+<sha>`
instead of their release tag, so `kosli version` in a container could
not name the release. Two causes in the Docker build path, both silent.
Any image published before v2.39.0 is affected. **Kept**, reworded
around that symptom.
- **v2.39.1** ([cli#1140](kosli-dev/cli#1140)) —
not a user-facing fix. It resolves the version once in the workflow
instead of via `git describe` in the build, superseding cli#1137's
`fetch-tags` approach, and fixes a smoke-test flake when a release tag
is cut at the same commit as an in-flight main pipeline. Its own
description says images "report what they did before … except the racy
case". **Dropped** as an internal build change.

That also removes the problem of two consecutive releases each claiming
to fix the image version with different causes.

Both bullets appeared only in the releases' "What's Changed" lists
rather than their curated sections, which is likely why the first pass
missed them.

## One correction worth noting

This branch described the v2.39.1 help-text change as affecting `kosli
snapshot azure-apps`. That name comes from the upstream release note,
but the command is `kosli snapshot azure` — the generated reference page
is `client_reference/kosli_snapshot_azure.md` and there is no
`azure-apps` page. `main`'s wording is correct and links the reference;
that is what was kept.

## Checks

- `mint broken-links` — clean apart from the pre-existing
`/getting_started/service-accounts` break in
`tutorials/working_with_controls.mdx`, which is on `main` and untouched
here.
- `<Update>` open/close tags balance at 117 each; no empty headings;
entries remain in newest-first date order.

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Dan Grøndahl <dan@kosli.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants