Skip to content

chore: add CLI v2.41.0–v2.43.1 changelog entries - #424

Merged
mbevc1 merged 2 commits into
mainfrom
mintlify/a334db01
Sep 21, 2026
Merged

mbevc1 merged 2 commits into
mainfrom
mintlify/a334db01

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Add changelog entries for four new CLI releases published in the scope window (Sep 14–21, 2026).

Changes

  • v2.43.1 (Sep 18) — attestation commands warn on missing repo; clearer errors when commit info can't be resolved.
  • v2.43.0 (Sep 17) — new kosli evaluate policy (evaluate + record in one call).
  • v2.42.0 (Sep 16) — parallel S3 downloads with byte budget; --sonar-revision with --pull-request; safer S3 key handling; drop legacy Visibility field; fix list flows panic.
  • v2.41.0 (Sep 15) — new kosli attest sbom (beta); Sonar token no longer follows redirects; Azure snapshot zip and log-digest hardening; CycloneDX SBOM tool read from services.

No new tags for terraform-provider-kosli (last v0.9.4 is already logged) or server (no tags) in the window.

@mintlify
mintlify Bot requested a review from a team as a code owner September 21, 2026 09:08
@mintlify

mintlify Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
kosli 🟢 Ready View Preview Sep 21, 2026, 9:12 AM

@mintlify
mintlify Bot requested a review from dangrondahl September 21, 2026 09:09
@claude

claude Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Claude finished @mbevc1's task in 2m 33s —— View job


Doc review

  • Read changelog/index.mdx at branch head (a840ac4)
  • Verified every linked reference page exists
  • Cross-checked claimed commands and flags against generated client_reference/
  • Checked <Update> format, dates, tags against existing entries
  • Posted findings

The reference tree is generated from v2.43.1 (client_reference/overview.md:7) — i.e. after every release in this entry — so it is a valid oracle for all four entries.


Critical — kosli evaluate policy does not exist in the reference

changelog/index.mdx:22. Still unresolved: the latest commit added **Beta** but not the underlying question.

  • No client_reference/kosli_evaluate_policy.md.
  • config/navigation.json:359-364 lists only kosli_evaluate_input, kosli_evaluate_trail, kosli_evaluate_trails.
  • kosli evaluate trail has no record/attest flag (client_reference/kosli_evaluate_trail.md:28-36--assert, --no-assert, --attestations, --params, --policy, --show-input).

Beta status alone doesn't hide a command from the reference — kosli attest decision is tag: "BETA" and has a page (client_reference/kosli_attest_decision.md:3), as does kosli attest sbom. So if this command shipped in v2.43.0 and were registered, v2.43.1's reference would have a page for it.

Note that kosli attest decision already "records a compliance decision against a control in a Kosli trail" (kosli_attest_decision.md:17). If v2.43.0 added a way to evaluate and record in one call, it is likelier a flag on an existing command than a new kosli evaluate policy subcommand. Please confirm the exact spelling against kosli-dev/cli v2.43.0 before merging; if the command is real but hidden, that's an upstream gap (kosli-dev/cli, cmd/kosli/evaluatePolicy.go) and this entry should say so rather than name a command with no page.

Minor — beta label diverges from the file's convention

changelog/index.mdx:22 uses a trailing **Beta**; every other beta announcement in this file — including the sibling bullet added by this same PR at :52 — puts it in the bold lead: **kosli attest sbom (beta)**, **kosli_control resource and data source (beta)** (:591), **Controls management (beta)** (:691).

Fix this →

Minor — v2.43.1 bullet 2 contradicts bullet 1 and the reference

Detailed inline on changelog/index.mdx:12. Short version: kosli_attest_jira.md:98 (generated at v2.43.1) says a defaulted, unresolvable commit produces a warning and the attestation is sent without commit info — which is bullet 1's behavior, not bullet 2's. Also pullrequest-* should be pullrequest * (space): kosli attest pullrequest github (kosli_attest_pullrequest_github.md:9).


Everything else checked out against the generated reference: --download-concurrency / --download-budget (kosli_snapshot_s3.md:39-40), --sonar-revision with --pull-request (kosli_attest_sonar.md:33,88), the kosli attest sbom formats, annotations and beta tag (kosli_attest_sbom.md:3,18-19,32-33), the Azure --digests-source logs hardening (kosli_snapshot_azure.md:32-36), and Visibility is indeed absent from the whole reference tree. All five links are root-relative and resolve; labels, dates and tags match existing entries.

I could not run mint broken-links in this job (no CLI installed), but all added links were checked by hand against the file tree.
• branch mintlify/a334db01

Comment thread changelog/index.mdx Outdated
Comment thread changelog/index.mdx Outdated

## New features

- **`kosli evaluate policy`** — evaluate a policy and record the decision in a single request, instead of calling evaluate and record separately.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Critical — command has no reference page. There is no client_reference/kosli_evaluate_policy.md, and the kosli evaluate group in config/navigation.json:359-363 lists only kosli_evaluate_input, kosli_evaluate_trail and kosli_evaluate_trails. The reference was generated from v2.43.1 (client_reference/overview.md:7), i.e. after the release this entry describes — so if the command existed, its page would be here.

This is also the only new-feature bullet in the PR with no reference link, which fits.

Either the command name is wrong (e.g. it's a flag on an existing kosli evaluate … subcommand), or the command exists upstream but is hidden/undocumented, in which case the fix is in kosli-dev/cli (cmd/kosli/evaluatePolicy.go) and this entry should not link to a page that will never exist.

I could not fetch the upstream release notes from this job to settle which, so please confirm against kosli-dev/cli v2.43.0 before merging.

mbevc1
mbevc1 previously approved these changes Sep 21, 2026
Comment thread changelog/index.mdx
## Updates

- **Attestation commands survive missing repositories** — `kosli attest` commands now warn (instead of failing) when a CI-defaulted `--commit` cannot be resolved because no repository is checked out, letting jobs without a repo continue.
- **Clearer errors when commit info is required** — `kosli attest pullrequest-*` and [`kosli attest jira`](/client_reference/kosli_attest_jira) now emit a descriptive error when the commit cannot be resolved, instead of silently proceeding or panicking. Explicit `--commit` or `--repo-root` values that fail to resolve now name the fix.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Contradicts the generated reference — and the bullet above it.

The reference was generated from v2.43.1 (client_reference/overview.md:7), so it already contains this change. It documents the opposite behavior for kosli attest jira:

client_reference/kosli_attest_jira.md:98 — "If both --commit and --repo-root are left at their defaults and the commit cannot be read from the repository, a warning is printed and the attestation is sent without commit info."

Same text on client_reference/kosli_attest_pullrequest_azure.md:37. That is exactly what bullet 1 (line 11) describes, so as written the two bullets in this entry disagree about what kosli attest jira does when a defaulted commit can't be resolved.

The second sentence ("explicit --commit or --repo-root values that fail to resolve") is consistent with both — scoping the whole bullet to the explicit case would resolve the conflict.

Separately: pullrequest-* implies commands named pullrequest-github. The actual commands use a space — kosli attest pullrequest github|gitlab|azure|bitbucket (client_reference/kosli_attest_pullrequest_github.md:9).

Fix this →

@mbevc1
mbevc1 merged commit db378a9 into main Sep 21, 2026
6 checks passed
@mbevc1
mbevc1 deleted the mintlify/a334db01 branch September 21, 2026 09:15

This branch was successfully deployed

1 active deployment
staging a840ac46 Deployed Sep 21, 2026 by mintlify[bot]
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.

1 participant