Merge branch 'moe/temporal-agent-cli' into moe/temporal-agent-cli-examples

Author: moedash

README.md

@@ -55,9 +55,9 @@ The CLI includes workflow commands optimized for AI agents, LLM tooling, and aut
 - **`temporal workflow list --failed`** - List recent workflow failures with auto-traversed root cause
 - **`temporal workflow describe --trace-root-cause`** - Trace a workflow through its child chain to the deepest failure
 - **`temporal workflow show --compact`** - Show a compact event timeline
-- **`temporal workflow show --format mermaid`** - Generate a sequence diagram
+- **`temporal workflow show --output mermaid`** - Generate a sequence diagram
 - **`temporal workflow describe --pending`** - Show pending activities, children, and Nexus operations
-- **`temporal workflow describe --format mermaid`** - Generate a state diagram
+- **`temporal workflow describe --output mermaid`** - Generate a state diagram
 - **`temporal tool-spec`** - Output tool specifications for AI agent frameworks
 
 ### Examples
@@ -131,23 +131,23 @@ temporal workflow list --failed --namespace commerce-ns --since 1h \
 
 ### Mermaid Visualization
 
-Commands support `--format mermaid` to generate visual diagrams:
+Commands support `--output mermaid` to generate visual diagrams:
 
 ```bash
 # Visualize workflow chain as a flowchart
-temporal workflow describe --trace-root-cause --workflow-id order-123 --namespace prod --format mermaid
+temporal workflow describe --trace-root-cause --workflow-id order-123 --namespace prod --output mermaid
 
 # Visualize timeline as a sequence diagram  
-temporal workflow show --workflow-id order-123 --namespace prod --format mermaid
+temporal workflow show --workflow-id order-123 --namespace prod --output mermaid
 
 # Visualize current state with pending activities
-temporal workflow describe --workflow-id order-123 --namespace prod --pending --format mermaid
+temporal workflow describe --workflow-id order-123 --namespace prod --pending --output mermaid
 
 # Visualize failures as a pie chart (when grouped)
-temporal workflow list --failed --namespace prod --since 1h --group-by error --format mermaid
+temporal workflow list --failed --namespace prod --since 1h --group-by error --output mermaid
 
 # Visualize failures as a flowchart (when not grouped)
-temporal workflow list --failed --namespace prod --since 1h --follow-children --format mermaid
+temporal workflow list --failed --namespace prod --since 1h --follow-children --output mermaid
 ```
 
 The mermaid output renders directly in:
@@ -156,7 +156,7 @@ The mermaid output renders directly in:
 - Notion pages
 - Any markdown preview with Mermaid support
 
-Example diagnose output with `--format mermaid`:
+Example diagnose output with `--output mermaid`:
 ```
 graph TD
     W0[🔄 OrderWorkflow<br/>Failed]

cliext/flags.gen.go

@@ -42,8 +42,8 @@ func (v *CommonOptions) BuildFlags(f *pflag.FlagSet) {
 	f.Var(&v.LogLevel, "log-level", "Log level. Default is \"info\" for most commands and \"warn\" for `server start-dev`. Accepted values: debug, info, warn, error, never.")
 	v.LogFormat = NewFlagStringEnum([]string{"text", "json", "pretty"}, "text")
 	f.Var(&v.LogFormat, "log-format", "Log format. Accepted values: text, json.")
-	v.Output = NewFlagStringEnum([]string{"text", "json", "jsonl", "none"}, "text")
-	f.VarP(&v.Output, "output", "o", "Non-logging data output format. Accepted values: text, json, jsonl, none.")
+	v.Output = NewFlagStringEnum([]string{"text", "json", "jsonl", "mermaid", "none"}, "text")
+	f.VarP(&v.Output, "output", "o", "Non-logging data output format. Accepted values: text, json, jsonl, mermaid, none.")
 	v.TimeFormat = NewFlagStringEnum([]string{"relative", "iso", "raw"}, "relative")
 	f.Var(&v.TimeFormat, "time-format", "Time format. Accepted values: relative, iso, raw.")
 	v.Color = NewFlagStringEnum([]string{"always", "never", "auto"}, "auto")

cliext/option-sets.yaml

@@ -70,6 +70,7 @@ option-sets:
           - text
           - json
           - jsonl
+          - mermaid
           - none
         default: text
       - name: time-format

internal/temporalcli/commands.gen.go

@@ -3407,7 +3407,6 @@ type TemporalWorkflowDescribeCommand struct {
 	TraceRootCause   bool
 	FollowNamespaces []string
 	Depth            int
-	Format           cliext.FlagStringEnum
 }
 
 func NewTemporalWorkflowDescribeCommand(cctx *CommandContext, parent *TemporalWorkflowCommand) *TemporalWorkflowDescribeCommand {
@@ -3417,9 +3416,9 @@ func NewTemporalWorkflowDescribeCommand(cctx *CommandContext, parent *TemporalWo
 	s.Command.Use = "describe [flags]"
 	s.Command.Short = "Show Workflow Execution info"
 	if hasHighlighting {
-		s.Command.Long = "Display information about a specific Workflow Execution:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId\x1b[0m\n\nShow the Workflow Execution's auto-reset points:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --reset-points true\x1b[0m\n\nShow pending activities, children, and Nexus operations:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --pending\x1b[0m\n\nGenerate a visual state diagram:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --pending \\\n    --format mermaid\x1b[0m\n\nTrace through child workflows to find root cause of failure:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --trace-root-cause\x1b[0m\n\nFollow children across namespaces:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --trace-root-cause \\\n    --follow-namespaces OtherNamespace1,OtherNamespace2 \\\n    --format mermaid\x1b[0m"
+		s.Command.Long = "Display information about a specific Workflow Execution:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId\x1b[0m\n\nShow the Workflow Execution's auto-reset points:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --reset-points true\x1b[0m\n\nShow pending activities, children, and Nexus operations:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --pending\x1b[0m\n\nGenerate a visual state diagram:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --pending \\\n    --output mermaid\x1b[0m\n\nTrace through child workflows to find root cause of failure:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --trace-root-cause\x1b[0m\n\nFollow children across namespaces:\n\n\x1b[1mtemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --trace-root-cause \\\n    --follow-namespaces OtherNamespace1,OtherNamespace2 \\\n    --output mermaid\x1b[0m"
 	} else {
-		s.Command.Long = "Display information about a specific Workflow Execution:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId\n```\n\nShow the Workflow Execution's auto-reset points:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --reset-points true\n```\n\nShow pending activities, children, and Nexus operations:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --pending\n```\n\nGenerate a visual state diagram:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --pending \\\n    --format mermaid\n```\n\nTrace through child workflows to find root cause of failure:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --trace-root-cause\n```\n\nFollow children across namespaces:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --trace-root-cause \\\n    --follow-namespaces OtherNamespace1,OtherNamespace2 \\\n    --format mermaid\n```"
+		s.Command.Long = "Display information about a specific Workflow Execution:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId\n```\n\nShow the Workflow Execution's auto-reset points:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --reset-points true\n```\n\nShow pending activities, children, and Nexus operations:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --pending\n```\n\nGenerate a visual state diagram:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --pending \\\n    --output mermaid\n```\n\nTrace through child workflows to find root cause of failure:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --trace-root-cause\n```\n\nFollow children across namespaces:\n\n```\ntemporal workflow describe \\\n    --workflow-id YourWorkflowId \\\n    --trace-root-cause \\\n    --follow-namespaces OtherNamespace1,OtherNamespace2 \\\n    --output mermaid\n```"
 	}
 	s.Command.Args = cobra.NoArgs
 	s.Command.Flags().BoolVar(&s.ResetPoints, "reset-points", false, "Show auto-reset points only.")
@@ -3428,8 +3427,6 @@ func NewTemporalWorkflowDescribeCommand(cctx *CommandContext, parent *TemporalWo
 	s.Command.Flags().BoolVar(&s.TraceRootCause, "trace-root-cause", false, "Trace through child workflow chain to find the deepest failure point. Automates following failed child workflows to find the actual root cause.")
 	s.Command.Flags().StringArrayVar(&s.FollowNamespaces, "follow-namespaces", nil, "Additional namespaces to follow when tracing child workflows. Used with --trace-root-cause. Can be passed multiple times.")
 	s.Command.Flags().IntVar(&s.Depth, "depth", 0, "Maximum depth to traverse when tracing child workflows. Zero means unlimited. Used with --trace-root-cause.")
-	s.Format = cliext.NewFlagStringEnum([]string{"default", "json", "mermaid"}, "")
-	s.Command.Flags().Var(&s.Format, "format", "Visual output format. Use \"mermaid\" to generate a state diagram showing pending work. Implies --pending. Accepted values: default, json, mermaid.")
 	s.WorkflowReferenceOptions.BuildFlags(s.Command.Flags())
 	s.Command.Run = func(c *cobra.Command, args []string) {
 		if err := s.run(cctx, args); err != nil {
@@ -3574,7 +3571,6 @@ type TemporalWorkflowListCommand struct {
 	LeafOnly         bool
 	CompactErrors    bool
 	GroupBy          cliext.FlagStringEnum
-	Format           cliext.FlagStringEnum
 }
 
 func NewTemporalWorkflowListCommand(cctx *CommandContext, parent *TemporalWorkflowCommand) *TemporalWorkflowListCommand {
@@ -3584,9 +3580,9 @@ func NewTemporalWorkflowListCommand(cctx *CommandContext, parent *TemporalWorkfl
 	s.Command.Use = "list [flags]"
 	s.Command.Short = "Show Workflow Executions"
 	if hasHighlighting {
-		s.Command.Long = "List Workflow Executions. The optional \x1b[1m--query\x1b[0m limits the output to\nWorkflows matching a Query:\n\n\x1b[1mtemporal workflow list \\\n    --query YourQuery\x1b[0m\n\nVisit https://docs.temporal.io/visibility to read more about Search Attributes\nand Query creation. See \x1b[1mtemporal batch --help\x1b[0m for a quick reference.\n\nView a list of archived Workflow Executions:\n\n\x1b[1mtemporal workflow list \\\n    --archived\x1b[0m\n\nList failed workflows from the last hour with root cause analysis:\n\n\x1b[1mtemporal workflow list \\\n    --failed \\\n    --since 1h\x1b[0m\n\nFollow child workflows to find root causes:\n\n\x1b[1mtemporal workflow list \\\n    --failed \\\n    --since 24h \\\n    --follow-children \\\n    --follow-namespaces OtherNamespace1,OtherNamespace2\x1b[0m\n\nGroup failures by error message to find patterns:\n\n\x1b[1mtemporal workflow list \\\n    --failed \\\n    --since 1h \\\n    --group-by error \\\n    --format mermaid\x1b[0m"
+		s.Command.Long = "List Workflow Executions. The optional \x1b[1m--query\x1b[0m limits the output to\nWorkflows matching a Query:\n\n\x1b[1mtemporal workflow list \\\n    --query YourQuery\x1b[0m\n\nVisit https://docs.temporal.io/visibility to read more about Search Attributes\nand Query creation. See \x1b[1mtemporal batch --help\x1b[0m for a quick reference.\n\nView a list of archived Workflow Executions:\n\n\x1b[1mtemporal workflow list \\\n    --archived\x1b[0m\n\nList failed workflows from the last hour with root cause analysis:\n\n\x1b[1mtemporal workflow list \\\n    --failed \\\n    --since 1h\x1b[0m\n\nFollow child workflows to find root causes:\n\n\x1b[1mtemporal workflow list \\\n    --failed \\\n    --since 24h \\\n    --follow-children \\\n    --follow-namespaces OtherNamespace1,OtherNamespace2\x1b[0m\n\nGroup failures by error message to find patterns:\n\n\x1b[1mtemporal workflow list \\\n    --failed \\\n    --since 1h \\\n    --group-by error \\\n    --output mermaid\x1b[0m"
 	} else {
-		s.Command.Long = "List Workflow Executions. The optional `--query` limits the output to\nWorkflows matching a Query:\n\n```\ntemporal workflow list \\\n    --query YourQuery\n```\n\nVisit https://docs.temporal.io/visibility to read more about Search Attributes\nand Query creation. See `temporal batch --help` for a quick reference.\n\nView a list of archived Workflow Executions:\n\n```\ntemporal workflow list \\\n    --archived\n```\n\nList failed workflows from the last hour with root cause analysis:\n\n```\ntemporal workflow list \\\n    --failed \\\n    --since 1h\n```\n\nFollow child workflows to find root causes:\n\n```\ntemporal workflow list \\\n    --failed \\\n    --since 24h \\\n    --follow-children \\\n    --follow-namespaces OtherNamespace1,OtherNamespace2\n```\n\nGroup failures by error message to find patterns:\n\n```\ntemporal workflow list \\\n    --failed \\\n    --since 1h \\\n    --group-by error \\\n    --format mermaid\n```"
+		s.Command.Long = "List Workflow Executions. The optional `--query` limits the output to\nWorkflows matching a Query:\n\n```\ntemporal workflow list \\\n    --query YourQuery\n```\n\nVisit https://docs.temporal.io/visibility to read more about Search Attributes\nand Query creation. See `temporal batch --help` for a quick reference.\n\nView a list of archived Workflow Executions:\n\n```\ntemporal workflow list \\\n    --archived\n```\n\nList failed workflows from the last hour with root cause analysis:\n\n```\ntemporal workflow list \\\n    --failed \\\n    --since 1h\n```\n\nFollow child workflows to find root causes:\n\n```\ntemporal workflow list \\\n    --failed \\\n    --since 24h \\\n    --follow-children \\\n    --follow-namespaces OtherNamespace1,OtherNamespace2\n```\n\nGroup failures by error message to find patterns:\n\n```\ntemporal workflow list \\\n    --failed \\\n    --since 1h \\\n    --group-by error \\\n    --output mermaid\n```"
 	}
 	s.Command.Args = cobra.NoArgs
 	s.Command.Flags().StringVarP(&s.Query, "query", "q", "", "Content for an SQL-like `QUERY` List Filter.")
@@ -3605,8 +3601,6 @@ func NewTemporalWorkflowListCommand(cctx *CommandContext, parent *TemporalWorkfl
 	s.Command.Flags().BoolVar(&s.CompactErrors, "compact-errors", false, "Extract the core error message, stripping wrapper context (used with --failed).")
 	s.GroupBy = cliext.NewFlagStringEnum([]string{"none", "type", "namespace", "status", "error"}, "none")
 	s.Command.Flags().Var(&s.GroupBy, "group-by", "Group failures by a field instead of listing individually. Returns aggregated counts per group (used with --failed). Accepted values: none, type, namespace, status, error.")
-	s.Format = cliext.NewFlagStringEnum([]string{"default", "json", "mermaid"}, "default")
-	s.Command.Flags().Var(&s.Format, "format", "Output format. Use \"mermaid\" for a visual diagram (used with --failed). Shows a pie chart when grouped, or a flowchart of failure chains. Accepted values: default, json, mermaid.")
 	s.Command.Run = func(c *cobra.Command, args []string) {
 		if err := s.run(cctx, args); err != nil {
 			cctx.Options.Fail(err)
@@ -3790,7 +3784,6 @@ type TemporalWorkflowShowCommand struct {
 	Compact           bool
 	EventTypes        []string
 	ExcludeEventTypes []string
-	Format            cliext.FlagStringEnum
 }
 
 func NewTemporalWorkflowShowCommand(cctx *CommandContext, parent *TemporalWorkflowCommand) *TemporalWorkflowShowCommand {
@@ -3800,18 +3793,16 @@ func NewTemporalWorkflowShowCommand(cctx *CommandContext, parent *TemporalWorkfl
 	s.Command.Use = "show [flags]"
 	s.Command.Short = "Display Event History"
 	if hasHighlighting {
-		s.Command.Long = "Show a Workflow Execution's Event History.\nWhen using JSON output (\x1b[1m--output json\x1b[0m), you may pass the results to an SDK\nto perform a replay:\n\n\x1b[1mtemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --output json\x1b[0m\n\nGenerate a visual sequence diagram of the workflow timeline:\n\n\x1b[1mtemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --format mermaid\x1b[0m\n\nShow a compact timeline (collapsed retries, focused events):\n\n\x1b[1mtemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --compact\x1b[0m"
+		s.Command.Long = "Show a Workflow Execution's Event History.\nWhen using JSON output (\x1b[1m--output json\x1b[0m), you may pass the results to an SDK\nto perform a replay:\n\n\x1b[1mtemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --output json\x1b[0m\n\nGenerate a visual sequence diagram of the workflow timeline:\n\n\x1b[1mtemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --output mermaid\x1b[0m\n\nShow a compact timeline (collapsed retries, focused events):\n\n\x1b[1mtemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --compact\x1b[0m"
 	} else {
-		s.Command.Long = "Show a Workflow Execution's Event History.\nWhen using JSON output (`--output json`), you may pass the results to an SDK\nto perform a replay:\n\n```\ntemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --output json\n```\n\nGenerate a visual sequence diagram of the workflow timeline:\n\n```\ntemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --format mermaid\n```\n\nShow a compact timeline (collapsed retries, focused events):\n\n```\ntemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --compact\n```"
+		s.Command.Long = "Show a Workflow Execution's Event History.\nWhen using JSON output (`--output json`), you may pass the results to an SDK\nto perform a replay:\n\n```\ntemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --output json\n```\n\nGenerate a visual sequence diagram of the workflow timeline:\n\n```\ntemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --output mermaid\n```\n\nShow a compact timeline (collapsed retries, focused events):\n\n```\ntemporal workflow show \\\n    --workflow-id YourWorkflowId\n    --compact\n```"
 	}
 	s.Command.Args = cobra.NoArgs
 	s.Command.Flags().BoolVarP(&s.Follow, "follow", "f", false, "Follow the Workflow Execution progress in real time. Does not apply to JSON output.")
 	s.Command.Flags().BoolVar(&s.Detailed, "detailed", false, "Display events as detailed sections instead of table. Does not apply to JSON output.")
 	s.Command.Flags().BoolVar(&s.Compact, "compact", false, "Show a compact event timeline focused on activities and workflows. Collapses retries and filters noise for easier debugging.")
 	s.Command.Flags().StringArrayVar(&s.EventTypes, "event-types", nil, "Filter to specific event types in compact mode. Can be passed multiple times.")
 	s.Command.Flags().StringArrayVar(&s.ExcludeEventTypes, "exclude-event-types", nil, "Exclude specific event types in compact mode. Can be passed multiple times.")
-	s.Format = cliext.NewFlagStringEnum([]string{"default", "mermaid"}, "")
-	s.Command.Flags().Var(&s.Format, "format", "Visual output format. Use \"mermaid\" to generate a sequence diagram of the workflow timeline. Implies --compact. Accepted values: default, mermaid.")
 	s.WorkflowReferenceOptions.BuildFlags(s.Command.Flags())
 	s.Command.Run = func(c *cobra.Command, args []string) {
 		if err := s.run(cctx, args); err != nil {