docs: update CLI and helm reference for v2.28.1

[github-actions]

Automated update of CLI and Helm reference documentation for release v2.28.1.

[mintlify]

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

Project	Status	Preview	Updated (UTC)
kosli	🟢 Ready	View Preview	Jun 22, 2026, 10:53 AM

[claude]

Claude finished @github-actions[bot]'s task in 1m 53s —— View job

---

Review of PR #283 — CLI & Helm reference update for v2.28.1

• Gather context and read CLAUDE.md
• Check new pages are in navigation.json
• Review changed files for content issues
• Check for relative links
• Post review findings

---

Automated reference docs update for v2.28.1. 85 files changed across client_reference/ and config/navigation.json. Beyond the routine live-data refresh, this PR introduces meaningful structural improvements.

What changed

1. New command: kosli attest decision (hidden: true, beta) — records compliance decisions against trail controls.
2. Navigation restructuring: The "Deprecated" nav group is removed. Deprecated commands move into their logical command groups (kosli assert, kosli get, kosli list, kosli snapshot), and new kosli report / kosli request groups are created. This is a good improvement — users find commands where they expect them.
3. Frontmatter modernization: beta: false/deprecated: false fields removed; deprecated: true → tag: "DEPRECATED"; beta: true → tag: "BETA". Inline deprecation/beta warnings replaced with shared snippets (<CliDeprecatedNotice />, <CliBetaNotice />). Both snippets exist and render correctly.
4. Live data refresh: JSON example outputs updated with current snapshot data across kosli get snapshot, kosli diff snapshots, kosli list environments, kosli log environment, kosli list snapshots, etc.
5. Version bump: overview.md → v2.28.1.

Findings

Suggestion — client_reference/kosli_attest_decision.md is a new page that is not in config/navigation.json. Since it's marked hidden: true, this is likely intentional (hidden beta command). Mintlify does support hidden pages in the nav config (they won't render in the sidebar), so adding it would keep routing explicit without affecting visibility. Low priority — no action needed if the generator intentionally omits hidden pages.

No issues found:

• No relative links — all internal links use root-relative paths (/integrations/ci_cd, /faq/#boolean-flags, /getting_started/install/, etc.).
• All previously-existing pages retain their navigation entries after the restructuring.
• The snippet imports use absolute paths (/snippets/cli-beta-notice.mdx), consistent with repo conventions.
• Frontmatter is well-formed across all changed files.

Looks good overall. The deprecation/beta snippet consolidation and navigation restructuring are clean improvements.