Kong/kongctl v1.3.0 on GitHub

kongctl Release Highlights

Welcome to kongctl v1.3.0! This release brings meaningful new capabilities
to declarative workflows and the interactive TUI, alongside a set of targeted
bug fixes.

✨ What's New

Remote File URL Support in Declarative Config

You can now reference configuration files by URL in your declarative manifests.
This removes the need to copy remote resources locally before running
plan, diff, or apply.

# Reference a remote config file directly
kongctl apply --config (example.com/redacted)

→ #1265

Dump Action in the View TUI

The interactive kongctl view TUI now includes a dump action, letting you
export the currently viewed resource directly from the UI without switching to
the command line.

→ #1264

`--overwrite-namespace` Flag for `adopt`

The adopt command gains a new --overwrite-namespace flag, giving you
explicit control over namespace handling when adopting existing resources into
declarative management.

kongctl adopt control-plane my-cp --overwrite-namespace my-namespace

→ #1220

🐛 Fixes & Improvements

Resolved nested event gateway policy references — declarative plans
involving nested event gateway policies now resolve correctly.
(#1277)
Empty audit-logs group omitted — declarative output no longer includes
an empty audit-logs group when no entries are present.
(#1263)
Team memberships scoped by namespace — fixed a bug where team memberships
were not correctly scoped to their team's namespace.
(#1261)
Frontmatter and API body metadata normalization — improves consistency
when applying configs that include API frontmatter.
(#1226)
Resource content omitted from text output — --output text no longer
emits raw resource content blobs, producing cleaner terminal output.
(#1223)

📚 Docs & DX

Telemetry now excludes meta/help commands, reducing noise.
(#1247)
Standardized PR title conventions documented and enforced for contributors.
(#1278)
Expanded E2E test coverage: dump --filter-id, event-gateway diff,
portal audit log webhook round-trips, and control-plane group idempotency.

🔗 Commit References

Features

0864a2a feat(declarative): add remote file URL support (#1265)
cdf74a6 Feat: Add dump action to view TUI (#1264)
a84cc0a Feat: support adopt namespace --overwrite-namespace flag and refactor current flag structure (#1220)
188b065 feat(e2e): add UPDATE and dump round-trip coverage for portal_audit_log_webhook (#1195)

Fixes

a820abd fix(declarative): Resolve nested event gateway policy refs (#1277)
5eaf9e3 fix(deps): update module github.com/daveshanley/vacuum to v0.27.1 (#1279)
8b58144 fix(deps): update module github.com/daveshanley/vacuum to v0.27.0 (#1272)
607e277 fix(deps): update module github.com/alecthomas/chroma/v2 to v2.26.0 (#1266)
f0ebef4 Fix: [declarative] omit empty audit-logs group (#1263)
dbd1ba7 Fix: scope team memberships by team namespace (#1261)
bfa0c37 fix(deps): update module golang.org/x/sys to v0.46.0 (#1260)
961d932 fix(deps): update module github.com/alecthomas/chroma/v2 to v2.25.0 (#1242)
eb67533 fix(deps): update module github.com/daveshanley/vacuum to v0.26.8 (#1239)
ef0462f fix(deps): update module github.com/kong/kongctl to v1.1.0 (#1243)
8e7ed6e fix(deps): update module github.com/kong/go-apiops to v0.4.2 (#1238)
3b1ba70 Fix: normalize frontmatter content and api body metadata (#1226)
0560043 Fix: omit resource content from text output (#1223)
dfb7d14 fix(deps): update module github.com/daveshanley/vacuum to v0.26.6 (#1215)
12ffe35 Task: Fix Renovate config JSON (#1257)

Other Changes

12a0e89 test(e2e): add functional coverage for dump --filter-id flag (#1274)
3ce3273 simplifier: simplify duplicate/verbose patterns in dump commands and TUI (#1273)
48b5de7 task(ci): publish successful feature-user evals as discussions (#1276)
705474e task(agents): add PR title conventions (#1278)
cb99e50 task(ci): redact UUIDs in feature-user artifacts (#1275)
1628191 test(e2e): exercise user team membership in dump/organization-teams scenario (#1236)
a9fc502 test(e2e): assert API publications in dump filtered scenario (#1252)
0a157b7 test(e2e): add read-after-write coverage for api_implementation in nested-child-lifecycle (#1251)
a76881b Task: telemetry - exclude meta commands (#1247)
398b573 Task: Exempt example SDK dependency from Renovate age limit (#1246)
5b01af1 Simplifier: remove redundant loop copies and replace sort.Slice with slices.SortFunc (#1244)
f1bc23f chore(deps): update github/gh-aw-actions action to v0.76.1 (#1241)
cb915fa test(e2e): scenario for adopt event-gateway command (#1232)
9939c1d test(e2e): add --overwrite-namespace coverage for adopt dcr-provider (#1231)
8bce547 Task: improve user agent eval workflow (#1235)
69ee371 chore(deps): update github/gh-aw-actions action to v0.75.4 (#1234)
1dd2c40 Simplify: Konnect adopt command setup and output handling (#1230)
b43ccba Task: guide e2e scanner toward scenario expansion (#1233)
5cf8169 chore(deps): update docker/setup-buildx-action action to v4.1.0 (#1219)
fb184a6 chore(deps): update docker/metadata-action action to v6.1.0 (#1218)
f7a54f5 chore(deps): update docker/login-action action to v4.2.0 (#1217)
10fb4d4 chore(deps): update golangci-lint (#1213)
c13771b test(e2e): add diff scenario for event-gateway resources (#1216)
28f49f6 chore(deps): update github/gh-aw-actions action to v0.75.2 (#1221)
14e9b8c chore(deps): update github/gh-aw-actions action to v0.75.0 (#1212)
2a2017b chore(deps): update docker/setup-qemu-action action to v4.1.0 (#1259)
f2a855e chore(deps): update github/gh-aw-actions action to v0.75.3 (#1225)
c8b4ed5 test(e2e): add control-plane group dump + round-trip idempotency scenario (#1207)
9de26ab Simplifier: extract menu mapping helpers in portal_customization_adapter (#1206)
be0a70f chore(deps): update docker/build-push-action action to v7.2.0 (#1209)
c494014 chore(deps): update step-security/harden-runner action to v2.19.4 (#1208)
9805c3e Task: add theme-aware logo to release highlights heading (#1205)
b809f41 chore(deps): update github/gh-aw-actions action to v0.74.9 (#1201)

Full Changelog: v1.2.1...v1.3.0

Generated by Release · ● 3.5M