feat(xid): add CLI/SDK support for xid bursts

api/openapi/openapi.yaml

@@ -1,3 +1,6 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
 info:
   title: Fleet Intelligence API (external)
   version: ''

cmd/nvfleetint/alert.go

@@ -176,7 +176,7 @@ func newAlertNodeCmd() *cobra.Command {
 	}
 
 	cmd.Flags().StringVar(&flags.view, "view", "", "Alert view: active or historical (default: active)")
-	cmd.Flags().StringVar(&flags.sortBy, "sort-by", "", "Sort field: component, startTime, or lastUpdate")
+	cmd.Flags().StringVar(&flags.sortBy, "sort-by", "", "Sort field: startTime or lastUpdate")
 	cmd.Flags().StringVar(&flags.order, "order", "", "Sort order: asc or desc")
 	cmd.Flags().StringVar(&flags.gpuType, "gpu-type", "", "Comma-separated GPU types to filter")
 	cmd.Flags().StringVar(&flags.nodeGroupIDs, "nodegroup-ids", "", "Comma-separated node group IDs to filter")
@@ -642,7 +642,7 @@ func validateAlertTimelineFlags(flags alertTimelineFlags, common resolvedCommonF
 	}
 	sortBy := nvfleetint.AlertTimelineAlertSortBy(strings.TrimSpace(flags.sortBy))
 	if sortBy != "" && !sortBy.Valid() {
-		return fmt.Errorf("invalid sort-by %q for node alerts: expected component, startTime, or lastUpdate", flags.sortBy)
+		return fmt.Errorf("invalid sort-by %q for node alerts: expected startTime or lastUpdate", flags.sortBy)
 	}
 	return nil
 }

cmd/nvfleetint/alert_test.go

@@ -521,6 +521,8 @@ func TestAlertTimelineRejectsInvalidFlags(t *testing.T) {
 	}{
 		{name: "summary sort", args: []string{"alert", "summary", "--sort-by", "startTime"}, want: "invalid sort-by"},
 		{name: "node sort", args: []string{"alert", "node", "node-1", "--sort-by", "alert"}, want: "invalid sort-by"},
+		// The API dropped the component sort; only startTime and lastUpdate remain.
+		{name: "node component sort", args: []string{"alert", "node", "node-1", "--sort-by", "component"}, want: "expected startTime or lastUpdate"},
 		{name: "missing node", args: []string{"alert", "node"}, want: "node UUID is required"},
 		{name: "state", args: []string{"alert", "summary", "--alert-state", "Triggered"}, want: "invalid alert-state"},
 		{name: "describe page", args: []string{"alert", "describe", "alert-1", "--node", "node-1", "--page", "2"}, want: "requires --page-size"},

cmd/nvfleetint/root.go

@@ -70,6 +70,7 @@ func newRootCmd() *cobra.Command {
 	cmd.AddCommand(newNodeCmd())
 	cmd.AddCommand(newAlertCmd())
 	cmd.AddCommand(newEventCmd())
+	cmd.AddCommand(newXIDBurstCmd())
 	cmd.AddCommand(newReportCmd())
 	cmd.AddCommand(newTagCmd())
 	cmd.AddCommand(newVersionCmd())