Skip to content

[APIE-989] Support Real Time Context Engine control plane commands#3331

Merged
Channing Dong (channingdong) merged 9 commits into
mainfrom
APIE-989
May 12, 2026
Merged

[APIE-989] Support Real Time Context Engine control plane commands#3331
Channing Dong (channingdong) merged 9 commits into
mainfrom
APIE-989

Conversation

@channingdong
Copy link
Copy Markdown
Contributor

@channingdong Channing Dong (channingdong) commented Apr 23, 2026

Release Notes

Breaking Changes

  • PLACEHOLDER

New Features

  • Add confluent rtce rtce-topic [ create | delete | describe | list | update ], and confluent rtce region list commands for managing Real Time Context Engine in Confluent Cloud

Bug Fixes

  • PLACEHOLDER

Checklist

  • I have successfully built and used a custom CLI binary, without linter issues from this PR.
  • I have clearly specified in the What section below whether this PR applies to Confluent Cloud, Confluent Platform, or both.
  • I have verified this PR in Confluent Cloud pre-prod or production environment, if applicable.
  • I have verified this PR in Confluent Platform on-premises environment, if applicable.
  • I have attached manual CLI verification results or screenshots in the Test & Review section below.
  • I have added appropriate CLI integration or unit tests for any new or updated commands and functionality.
  • I confirm that this PR introduces no breaking changes or backward compatibility issues.
  • I have indicated the potential customer impact if something goes wrong in the Blast Radius section below.
  • I have put checkmarks below confirming that the feature associated with this PR is enabled in:
    • Confluent Cloud prod
    • Confluent Cloud stag
    • Confluent Platform
    • Check this box if the feature is enabled for certain organizations only

What

This PR adds the new CLI commands for managing Real Time Context Engine control plane resources.

Blast Radius

This is an additive feature, so no impact on existing commands.

References

https://confluentinc.atlassian.net/browse/APIE-989

Test & Review

The manual verification confirmation can be found in below Slack threads:

https://confluent.slack.com/archives/C096C1HM5FD/p1776721083029179?thread_ts=1776449646.592909&cid=C096C1HM5FD

https://confluent.slack.com/archives/C096C1HM5FD/p1777389486152819?thread_ts=1776449646.592909&cid=C096C1HM5FD

Copilot AI review requested due to automatic review settings April 23, 2026 00:29
@channingdong Channing Dong (channingdong) requested a review from a team as a code owner April 23, 2026 00:29
@confluent-cla-assistant
Copy link
Copy Markdown

🎉 All Contributor License Agreements have been signed. Ready to merge.
Please push an empty commit if you would like to re-run the checks to verify CLA status for all contributors.

Comment thread go.mod Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Introduces initial generated CLI and client support for Symphony/RTCE control plane APIs, including RTCE regions and RTCE topic CRUD, plus corresponding test-server routes and tests.

Changes:

  • Add RTCE API client wiring and list/create/get/update/delete helpers in pkg/ccloudv2.
  • Add confluent rtce command group with region list and rtce-topic subcommands.
  • Add test-server handlers/routes and new integration/live tests for RTCE commands.

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
pkg/ccloudv2/client.go Wires an RTCE SDK client into the shared v2 client.
pkg/ccloudv2/rtce.go Adds RTCE API wrapper methods (topics + regions).
internal/command.go Registers the new rtce top-level command group.
internal/rtce/* Implements RTCE CLI commands (regions + rtce-topic CRUD + autocomplete).
test/test-server/ccloudv2_router.go Registers RTCE routes in the test server.
test/test-server/region_handler.go Adds test-server handler for RTCE regions.
test/test-server/rtce_topic_handler.go Adds test-server handlers for RTCE topics endpoints.
test/region_test.go Adds integration tests for rtce region list.
test/rtce_topic_test.go Adds integration tests for rtce rtce-topic commands.
test/live/region_live_test.go Adds live test for RTCE region listing.
test/live/rtce_topic_live_test.go Adds live CRUD test for RTCE topics.
go.mod Adds RTCE SDK dependency (currently with a local replace).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread internal/rtce/command_rtce_topic.go
Comment thread test/live/region_live_test.go
Comment thread internal/rtce/command_rtce_topic_create.go
Comment thread test/rtce_topic_test.go
Comment thread test/region_test.go
Comment thread test/test-server/rtce_topic_handler.go Outdated
Comment thread test/test-server/rtce_topic_handler.go Outdated
Comment thread go.mod Outdated
Comment thread test/test-server/rtce_topic_handler.go
Comment thread test/test-server/region_handler.go
Comment thread internal/rtce/command_region.go
Comment thread internal/rtce/command_rtce_topic.go Outdated
@channingdong Channing Dong (channingdong) changed the title [APIE-989] Initial generated code for Symphony control plane APIs (Don't Merge) [APIE-989] Initial generated code for Symphony control plane APIs (Don't Merge Yet) May 9, 2026
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 57 out of 58 changed files in this pull request and generated 3 comments.

Comment thread test/live/rtce_topic_live_test.go
Comment thread test/test-server/rtce_topic_handler.go Outdated
Comment thread internal/rtce/command_rtce_topic_create.go Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 57 out of 58 changed files in this pull request and generated 4 comments.

Comment thread test/test-server/rtce_topic_handler.go
Comment thread test/test-server/region_handler.go
Comment thread test/live/rtce_topic_live_test.go
Comment thread test/live/rtce_topic_live_test.go
@channingdong Channing Dong (channingdong) changed the title [APIE-989] Initial generated code for Symphony control plane APIs (Don't Merge Yet) [APIE-989] Support Real Time Context Engine control plane commands May 12, 2026
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Nice! Some comments:

Comment thread internal/rtce/command_region.go
Comment thread internal/rtce/command_rtce_topic.go Outdated
Comment on lines +54 to +55
if environmentId != "" {
specUpdate.Environment = &rtcev1.EnvScopedObjectReference{Id: environmentId}
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Possible followup: the spec marks this as required in the PATCH request, so we could update it so that required attributes don't have this guard condition.

The cluster isn't marked as required, though. Which is a bit odd... that one should also be necessary to define the right scope

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

environment is required in OpenAPI yaml, but optional in CLI command registration, because of the config thing.

But we can indeed remove the if statement here because if environmentId is empty, the backend is going to b complain anyway, and this only happens for the scenario where user doesn't have an active environment to work with.

@sonarqube-confluent
Copy link
Copy Markdown

@channingdong Channing Dong (channingdong) added the cli-terraform-generator This PR is generated automatically from cli-terraform-generator tool label May 12, 2026
@channingdong Channing Dong (channingdong) merged commit 0fe9528 into main May 12, 2026
3 checks passed
@channingdong Channing Dong (channingdong) deleted the APIE-989 branch May 12, 2026 21:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cli-terraform-generator This PR is generated automatically from cli-terraform-generator tool

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants