cli: make bundled help self-describing

packages/orch-runtime/internal/cli/orch/cancel.go

@@ -21,6 +21,13 @@ func newCancelCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "cancel",
 		Short: "Cancel a task or an entire run",
+		Long: helpLong(
+			"Use cancel to stop one task or an entire run.",
+			"Pass --task when you want to cancel one task inside the run; omit it when you want to cancel the whole run.",
+			"Use a reason when later readers need to understand why the work was stopped.",
+		),
+		Example: `  orch --db .agents/coord.db cancel --run blog_mvp_001 --task T3 --reason "Superseded by a new plan."
+  orch --db .agents/coord.db cancel --run blog_mvp_001 --reason "User cancelled the entire request."`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()