Skip to content

Fix standalone activity stability labels and polish help docs - #1196

Open
fretz12 wants to merge 2 commits into
mainfrom
fredtzeng/saa-help-cleanup
Open

Fix standalone activity stability labels and polish help docs#1196
fretz12 wants to merge 2 commits into
mainfrom
fredtzeng/saa-help-cleanup

Conversation

@fretz12

@fretz12 fretz12 commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

What changed?

  • Removed the (Experimental) label from stable Standalone Activity commands.
  • Marked activity pause, unpause, reset, and update-options as experimental.
  • Updated Activity and Batch help text to accurately document Standalone Activity operations.
  • Fixed related documentation wording and regenerated commands.gen.go.

@fretz12
fretz12 requested a review from a team as a code owner September 8, 2026 23:15

Copilot AI left a comment

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.

🟡 Changes recommended

One updated help area still contains misleading --query guidance for standalone Activity targeting, which contradicts actual supported flag combinations.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR updates Temporal CLI command metadata and generated help output to reflect current stability/experimental status of Standalone Activity operations, and improves Activity/Batch help wording to better document bulk operations via --query.

Changes:

  • Removed “(Experimental)” from stable Standalone Activity commands (e.g., cancel, list, start, terminate).
  • Marked activity pause, unpause, reset, and update-options as experimental and added explicit experimental notes in their help text.
  • Polished Batch help text and several flag descriptions (e.g., --yes, --rps) to better describe batch behavior and Standalone Activity batch use cases.
File summaries
File Description
internal/temporalcli/commands.yaml Adjusts command summaries/descriptions and Batch documentation to reflect stability and standalone activity batch operations.
internal/temporalcli/commands.gen.go Regenerates CLI help strings to match updated command metadata and improved flag/help text wording.
Review details
  • Files reviewed: 2/2 changed files
  • Comments generated: 1
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 183 to +187
f.StringVarP(&v.WorkflowId, "workflow-id", "w", "", "Workflow ID. Set to target a workflow Activity. Omit to target a standalone Activity. For a Workflow Activity you must set either --workflow-id or --query.")
f.StringVarP(&v.Query, "query", "q", "", "Content for an SQL-like `QUERY` List Filter. You must set either --workflow-id or --query. Note: Using --query for batch activity operations is an experimental feature and may change in the future.")
f.StringVarP(&v.RunId, "run-id", "r", "", "Run ID. Only use with --workflow-id or --activity-id. Cannot use with --query.")
f.StringVar(&v.Reason, "reason", "", "Reason for batch operation. Only use with --query. Defaults to user name.")
f.BoolVarP(&v.Yes, "yes", "y", false, "Don't prompt to confirm signaling. Only allowed when --query is present.")
f.Float32Var(&v.Rps, "rps", 0, "Limit batch's requests per second. Only allowed if query is present.")
f.BoolVarP(&v.Yes, "yes", "y", false, "Don't prompt to confirm the batch operation. Only allowed when --query is present.")
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.

2 participants