Add vendor update and diff commands

cmd/vendor_diff.go

@@ -8,15 +8,18 @@ import (
 
 // vendorDiffCmd executes 'vendor diff' CLI commands.
 var vendorDiffCmd = &cobra.Command{
-	Use:                "diff",
-	Short:              "Show differences in vendor configurations or dependencies",
-	Long:               "This command compares and displays the differences in vendor-specific configurations or dependencies.",
+	Use:   "diff",
+	Short: "Show Git diff between two versions of a vendored component",
+	Long: `This command shows the Git diff between two versions of a vendored component from the remote repository.
+
+The command uses Git to compare two refs (tags, branches, or commits) without requiring a local clone.
+Output is colorized automatically when output is to a terminal.
+
+Use --from and --to to specify versions, or let it default to current version vs latest.`,
 	FParseErrWhitelist: struct{ UnknownFlags bool }{UnknownFlags: false},
+	Args:               cobra.NoArgs,
 	RunE: func(cmd *cobra.Command, args []string) error {
-		handleHelpRequest(cmd, args)
-		// TODO: There was no documentation here:https://atmos.tools/cli/commands/vendor we need to know what this command requires to check if we should add usage help
-
-		// Check Atmos configuration
+		// Vendor diff doesn't require stack validation
 		checkAtmosConfig()
 
 		err := e.ExecuteVendorDiffCmd(cmd, args)
@@ -25,11 +28,12 @@ var vendorDiffCmd = &cobra.Command{
 }
 
 func init() {
-	vendorDiffCmd.PersistentFlags().StringP("component", "c", "", "Compare the differences between the local and vendored versions of the specified component.")
-	AddStackCompletion(vendorDiffCmd)
-	vendorDiffCmd.PersistentFlags().StringP("type", "t", "terraform", "Compare the differences between the local and vendored versions of the specified component, filtering by type (terraform or helmfile).")
-	vendorDiffCmd.PersistentFlags().Bool("dry-run", false, "Simulate the comparison of differences between the local and vendored versions of the specified component without making any changes.")
-
-	// Since this command is not implemented yet, exclude it from `atmos help`
-	// vendorCmd.AddCommand(vendorDiffCmd)
+	vendorDiffCmd.PersistentFlags().StringP("component", "c", "", "Component to diff (required)")
+	_ = vendorDiffCmd.RegisterFlagCompletionFunc("component", ComponentsArgCompletion)
+	vendorDiffCmd.PersistentFlags().String("from", "", "Starting version/tag/commit (defaults to current version in vendor.yaml)")
+	vendorDiffCmd.PersistentFlags().String("to", "", "Ending version/tag/commit (defaults to latest)")
+	vendorDiffCmd.PersistentFlags().String("file", "", "Show diff for specific file within component")
+	vendorDiffCmd.PersistentFlags().IntP("context", "C", 3, "Number of context lines")
+	vendorDiffCmd.PersistentFlags().Bool("unified", true, "Show unified diff format")
+	vendorCmd.AddCommand(vendorDiffCmd)
 }

cmd/vendor_update.go

@@ -0,0 +1,39 @@
+package cmd
+
+import (
+	"github.com/spf13/cobra"
+
+	e "github.com/cloudposse/atmos/internal/exec"
+)
+
+// vendorUpdateCmd executes 'vendor update' CLI commands.
+var vendorUpdateCmd = &cobra.Command{
+	Use:   "update",
+	Short: "Update version references in vendor configurations to their latest versions",
+	Long: `This command checks upstream Git sources for newer versions and updates the version references in vendor configuration files.
+
+The command supports checking Git repositories for newer tags and commits, and will preserve YAML structure including anchors, comments, and formatting.
+
+Use the --check flag to see what updates are available without making changes.
+Use the --pull flag to both update version references and pull the new components.`,
+	FParseErrWhitelist: struct{ UnknownFlags bool }{UnknownFlags: false},
+	Args:               cobra.NoArgs,
+	RunE: func(cmd *cobra.Command, args []string) error {
+		// Vendor update doesn't require stack validation
+		checkAtmosConfig()
+
+		err := e.ExecuteVendorUpdateCmd(cmd, args)
+		return err
+	},
+}
+
+func init() {
+	vendorUpdateCmd.PersistentFlags().Bool("check", false, "Check for updates without modifying configuration files (dry-run mode)")
+	vendorUpdateCmd.PersistentFlags().Bool("pull", false, "Update version references AND pull the new component versions")
+	vendorUpdateCmd.PersistentFlags().StringP("component", "c", "", "Update version for the specified component name")
+	_ = vendorUpdateCmd.RegisterFlagCompletionFunc("component", ComponentsArgCompletion)
+	vendorUpdateCmd.PersistentFlags().String("tags", "", "Update versions for components with the specified tags (comma-separated)")
+	vendorUpdateCmd.PersistentFlags().StringP("type", "t", "terraform", "Component type: terraform or helmfile")
+	vendorUpdateCmd.PersistentFlags().Bool("outdated", false, "Show only components with available updates (use with --check)")
+	vendorCmd.AddCommand(vendorUpdateCmd)
+}