STAC-24174: validate version

Author: deontaljaard

cmd/stackpack/stackpack_validate.go

@@ -14,10 +14,11 @@ import (
 
 // ValidateArgs contains arguments for stackpack validate command
 type ValidateArgs struct {
-	Name          string
-	StackpackDir  string
-	StackpackFile string
-	DockerImage   string
+	Name             string
+	StackpackDir     string
+	StackpackFile    string
+	DockerImage      string
+	StackpackVersion string
 
 	dockerRunner func([]string) error
 }
@@ -44,6 +45,9 @@ This command is experimental and requires STS_EXPERIMENTAL_STACKPACK environment
 		Example: `# Validate using API
 sts stackpack validate --name my-stackpack
 
+# Validate a specific version using API
+sts stackpack validate --name my-stackpack --stackpack-version 1.2.3
+
 # Validate using Docker with a directory
 sts stackpack validate --image quay.io/stackstate/stackstate-server:latest --stackpack-directory ./my-stackpack
 
@@ -56,6 +60,7 @@ sts stackpack validate --image quay.io/stackstate/stackstate-server:latest --sta
 	cmd.Flags().StringVarP(&args.StackpackDir, "stackpack-directory", "d", "", "Path to stackpack directory (Docker mode)")
 	cmd.Flags().StringVarP(&args.StackpackFile, "stackpack-file", "f", "", "Path to .sts file (Docker mode)")
 	cmd.Flags().StringVar(&args.DockerImage, "image", "", "Docker image reference (triggers Docker mode)")
+	cmd.Flags().StringVar(&args.StackpackVersion, "stackpack-version", "", "Stackpack version to validate (optional, defaults to latest)")
 
 	// Set default docker runner if not already set
 	if args.dockerRunner == nil {
@@ -107,7 +112,11 @@ func runAPIValidation(cli *di.Deps, cmd *cobra.Command, args *ValidateArgs) comm
 	}
 
 	// Call validate endpoint
-	_, resp, validateErr := api.StackpackApi.ValidateStackPack(cli.Context, args.Name).Execute()
+	request := api.StackpackApi.ValidateStackPack(cli.Context, args.Name)
+	if args.StackpackVersion != "" {
+		request = request.Version(args.StackpackVersion)
+	}
+	_, resp, validateErr := request.Execute()
 	if validateErr != nil {
 		return common.NewResponseError(validateErr, resp)
 	}

cmd/stackpack/stackpack_validate_test.go

@@ -104,6 +104,18 @@ func TestValidate_APIMode_MissingName(t *testing.T) {
 	assert.Contains(t, err.Error(), "name is required")
 }
 
+func TestValidate_APIMode_WithStackpackVersion(t *testing.T) {
+	cli, cmd := setupValidateCmd(t)
+
+	_, err := di.ExecuteCommandWithContext(&cli.Deps, cmd, "--name", "my-stackpack", "--stackpack-version", "1.2.3")
+	require.NoError(t, err)
+
+	// Verify success message
+	require.NotEmpty(t, *cli.MockPrinter.SuccessCalls)
+	successCall := (*cli.MockPrinter.SuccessCalls)[0]
+	assert.Contains(t, successCall, "validation successful")
+}
+
 // ===== Docker Mode Tests =====
 
 func TestValidate_DockerMode_MissingImage(t *testing.T) {

generated/stackstate_api/api/openapi.yaml

@@ -413,6 +413,13 @@ paths:
         required: true
         schema:
           type: string
+      - description: "Optional version string (e.g. '1.2.3'). If not provided, validates\
+          \ the latest version."
+        in: query
+        name: version
+        required: false
+        schema:
+          type: string
       responses:
         "200":
           content:

generated/stackstate_api/api_stackpack.go

@@ -435,7 +435,7 @@ Name | Type | Description  | Notes
 
 ## ValidateStackPack
 
-> string ValidateStackPack(ctx, stackPackName).Execute()
+> string ValidateStackPack(ctx, stackPackName).Version(version).Execute()
 
 Validate API
 
@@ -455,10 +455,11 @@ import (
 
 func main() {
     stackPackName := "stackPackName_example" // string | 
+    version := "version_example" // string | Optional version string (e.g. '1.2.3'). If not provided, validates the latest version. (optional)
 
     configuration := openapiclient.NewConfiguration()
     apiClient := openapiclient.NewAPIClient(configuration)
-    resp, r, err := apiClient.StackpackApi.ValidateStackPack(context.Background(), stackPackName).Execute()
+    resp, r, err := apiClient.StackpackApi.ValidateStackPack(context.Background(), stackPackName).Version(version).Execute()
     if err != nil {
         fmt.Fprintf(os.Stderr, "Error when calling `StackpackApi.ValidateStackPack``: %v\n", err)
         fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
@@ -484,6 +485,7 @@ Other parameters are passed through a pointer to a apiValidateStackPackRequest s
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
 
+ **version** | **string** | Optional version string (e.g. '1.2.3'). If not provided, validates the latest version. | 
 
 ### Return type
 

generated/stackstate_api/docs/StackpackApi.md

@@ -1 +1 @@
-7dda64436db2c041092b31af19b541977a3699dc
+36a7262f51769ebff26827b33e2ebf8afd9b0f69