feat(profilecli): Add --max-nodes flag to query profile command (#4433)

Add support for limiting the number of nodes returned in profile queries
through the new --max-nodes flag. This matches the functionality available
in buf curl but was missing from profilecli.

Reference: grafana/pyroscope-squad#568 (comment)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <[email protected]>

Author: korniltsev-grafanista

cmd/profilecli/query.go

@@ -94,13 +94,15 @@ type queryProfileParams struct {
 	*queryParams
 	ProfileType        string
 	StacktraceSelector []string
+	MaxNodes           int64
 }
 
 func addQueryProfileParams(queryCmd commander) *queryProfileParams {
 	params := new(queryProfileParams)
 	params.queryParams = addQueryParams(queryCmd)
 	queryCmd.Flag("profile-type", "Profile type to query.").Default("process_cpu:cpu:nanoseconds:cpu:nanoseconds").StringVar(&params.ProfileType)
 	queryCmd.Flag("stacktrace-selector", "Only query locations with those symbols. Provide multiple times starting with the root").StringsVar(&params.StacktraceSelector)
+	queryCmd.Flag("max-nodes", "Maximum number of nodes to return in the profile").Int64Var(&params.MaxNodes)
 	return params
 }
 
@@ -118,6 +120,10 @@ func queryProfile(ctx context.Context, params *queryProfileParams, outputFlag st
 		LabelSelector: params.Query,
 	}
 
+	if params.MaxNodes > 0 {
+		req.MaxNodes = &params.MaxNodes
+	}
+
 	if len(params.StacktraceSelector) > 0 {
 		locations := make([]*typesv1.Location, 0, len(params.StacktraceSelector))
 		for _, cs := range params.StacktraceSelector {