v1.11.0

kongctl Release Highlights

✨ What's New

Skip API defaults in declarative dumps (#1843)
The new --skip-defaults flag for kongctl dump declarative omits fields that match Konnect API defaults, producing cleaner, more readable YAML. Defaults are derived lazily from SDK metadata with documented resource-scoped overrides.

kongctl dump declarative --skip-defaults -o my-config.yaml

AI Gateway API 0.10.3 + 0.11.1 support (#1844, #1864)
kongctl now supports the latest AI Gateway capabilities including MCP server OpenID Connect/OAuth2 configuration, identity-provider associations for MCP servers and agents, expanded model cost configuration, and agent/MCP server upstream and proxy configuration via sdk-konnect-go v0.58.0.

Extension host flag visibility control (#1832)
Extension commands can now selectively hide irrelevant host flags from --help output. Commands that operate locally (like file converters) no longer display seven unused Konnect connection flags.

Hands-on kongctl learning guide (#1708)
A new book-style, interactive learning site covers setup, CLI configuration, declarative configuration, federated management, and extensions — with a complete AI Gateway walkthrough from creation through sync and deletion.

🐛 Fixes & Improvements

• Portal empty menu arrays preserved (#1805) — Explicitly empty portal customization menus now round-trip correctly through dump/apply instead of being silently dropped.
• Organization system-account dump coverage (#1815) — dump declarative --resources=organization.teams --include-child-resources now exports system-account role and team assignments.
• Broken extension links stay recoverable (#1806) — When an extension record is damaged, built-in commands and help remain available with structured recovery diagnostics instead of a hard failure.
• Login banner respects terminal height (#1839) — The static Kong login banner no longer overflows small or unsized terminals; it now requires a measured width and height before rendering.
• Redacted AWS credentials ignored in diffs (#1864) — Declarative comparisons now skip redacted upstream AWS credentials, preventing false diff noise.

📚 Docs & DX

• Hands-on learning guide with interactive chapters and a complete AI Gateway walkthrough (#1708)
• Portal IdP adapter simplified with consolidated nil guards (#1808)
• Dump sort comparators simplified using cmp.Compare (#1831)

🔗 Commit References

Features

• 94eefff feat(declarative): add skip-defaults to declarative dumps (#1843)
• 4f8eb1b feat(declarative): support AI Gateway API 0.10.3 (#1844)
• e9b8f0b feat(extensions): control host flag visibility in command help (#1832)
• ef47185 feat(docs): add hands-on kongctl learning guide (#1708)

Fixes

• 0f0c474 fix(declarative): preserve empty portal menu arrays (#1805)
• 9c759eb fix(declarative): reuse boolean explain kind (#1857)
• 4c91afc fix(dump): export organization system-account assignments (#1815)
• c12269f fix(extensions): keep broken links recoverable (#1806)
• df9dd91 fix(konnect): gate static login banner on terminal height (#1839)
• a25489e fix(deps): update all non-major dependencies with stable versions (#1849)
• 64d41ad fix(deps): update module github.com/kong/kongctl to v1.10.0 (#1797)
• be9e6ff fix(deps): update module github.com/mattn/go-isatty to v0.0.24 (#1796)
• 91aa226 fix(deps): update module github.com/mattn/go-runewidth to v0.0.27 (#1798)
• f599337 fix(deps): update module github.com/santhosh-tekuri/jsonschema/v6 to v6.0.3 (#1818)

Other Changes

• cb2105c task(sdk): update sdk-konnect-go to v0.58.0 (#1864)
• 9eb13e6 refactor(declarative): simplify portal IdP adapter and nil guards (#1808)
• f1fe6fd refactor(simplify): use cmp.Compare in dump sort comparators (#1831)
• fec9bab task(ci): migrate agentic workflows to Claude federation (#1871)
• 5aa6b87 task(ci): pilot Claude federation for E2E scanner (#1867)
• 57379df task(e2e): split concurrency by Konnect environment (#1852)
• dcca1ac task(deps): update TypeScript to v6 (#1866)
• cb57896 test(e2e): add AI Gateway dump round-trip scenario (#1823)
• 4bb3343 test(e2e): add ai_gateway bootstrap CREATE assertion to diff coverage scenario (#1824)
• c5b9acb test(e2e): add API dump round-trip coverage for array attributes (#1792)
• 367f328 test(e2e): add no-op API plan checks to comprehensive-fields scenario (#1793)
• 4372597 test(e2e): expand org user dump assertions (#1814)
• a57ed17 test(e2e): expand require-namespace multi-value coverage (#1807)
• 1f0a5df test(e2e): verify control plane fields after create (#1810)
• 30eba18 test(e2e): verify control-plane proxy URLs after sync (#1811)
• 693ce96 chore(deps): update docker/login-action action to v4.5.0 (#1791)
• 4c36645 chore(deps): update docker/login-action action to v4.5.1 (#1804)
• 6404104 chore(deps): update docker/login-action action to v4.5.2 (#1833)
• 6e2e429 chore(deps): update docker/login-action action to v4.6.0 (#1835)
• f336df6 chore(deps): update github/gh-aw-actions action to v0.83.2 (#1802)
• 7e8a409 chore(deps): update github/gh-aw-actions action to v0.83.3 (#1817)
• 01fa8fb chore(deps): update github/gh-aw-actions action to v0.83.5 (#1829)
• e35e92a chore(deps): update github/gh-aw-actions action to v0.84.0 (#1840)
• 8a7620e chore(deps): update actions/checkout action to v7.0.1 (#1847)
• 2bf64f5 chore(deps): update actions/setup-node action to v6.5.0 (#1850)
• da80444 chore(deps): update actions/setup-node action to v7 (#1854)
• e97835e chore(deps): update actions/configure-pages action to v6 (#1853)
• d6e7624 chore(deps): update actions/upload-pages-artifact action to v5 (#1855)
• 88c8ac5 chore(deps): update dependency jsdom to v30 (#1856)
• 4bec63f chore(deps): update node.js to v24.18.1 (#1848)
• 4cdb998 build(deps): bump js-yaml from 4.3.0 to 4.3.1 in /site (#1846)
• 869d9c9 build(deps-dev): bump fast-uri from 3.1.4 to 3.1.5 in /site (#1845)

---

Full Changelog: v1.10.0...v1.11.0> Generated by Release · opus46 · 124.2 AIC · ⌖ 31.7 AIC · ⊞ 4.4K