feat: add version command to display application version and build info

Author: sathirak

cmd/root.go

@@ -1,8 +1,10 @@
 package cmd
 
 import (
+	"fmt"
 	"wavezync/pulse-bridge/cmd/pulsebridge"
 	"wavezync/pulse-bridge/internal/env"
+	"wavezync/pulse-bridge/internal/version"
 
 	"github.com/rs/zerolog"
 	"github.com/rs/zerolog/log"
@@ -16,10 +18,16 @@ var (
 )
 
 var rootCmd = &cobra.Command{
-	Use:   "pulsebridge",
-	Short: "pulsebridge is a powerful uptime monitoring tool",
-	Long:  `pulsebridge exposes internal service status via HTTP, enabling seamless integration with external monitoring tools like Atlassian Statuspage.`,
+	Use:     "pulsebridge",
+	Short:   "pulsebridge is a powerful uptime monitoring tool",
+	Long:    `pulsebridge exposes internal service status via HTTP, enabling seamless integration with external monitoring tools like Atlassian Statuspage.`,
 	RunE: func(cmd *cobra.Command, args []string) error {
+		versionFlag, _ := cmd.Flags().GetBool("version")
+		if versionFlag {
+			fmt.Println(version.GetVersionWithBuildInfo())
+			return nil
+		}
+
 		envConfig := env.Init()
 
 		if cmd.Flags().Changed("config") {
@@ -40,6 +48,7 @@ func init() {
 	rootCmd.PersistentFlags().StringVar(&configPath, "config", "config.yml", "Path to configuration file")
 	rootCmd.PersistentFlags().StringVar(&host, "host", "0.0.0.0", "Host address to bind the server")
 	rootCmd.PersistentFlags().IntVar(&port, "port", 8080, "Port to run the server")
+	rootCmd.PersistentFlags().BoolP("version", "v", false, "Print the version and exit")
 }
 
 func Execute() {

internal/version/version.go

@@ -0,0 +1,103 @@
+package version
+
+import (
+	"fmt"
+	"runtime"
+	"runtime/debug"
+	"strings"
+)
+
+var (
+	version string
+	tag     string 
+	commit  string
+	dirty   bool
+)
+
+func init() {
+	// Always attempt to get build info from the Go runtime, regardless of build type.
+	if info, ok := debug.ReadBuildInfo(); ok {
+		if version == "" {
+			// If version wasn't set via ldflags, try to get it from VCS info
+			version = getVersionFromVCS(info)
+		}
+		commit = getCommit(info)
+		dirty = getDirty(info)
+	}
+
+	// Fallback version if nothing else is available
+	if version == "" {
+		version = "dev"
+	}
+}
+
+func getVersionFromVCS(info *debug.BuildInfo) string {
+	for _, setting := range info.Settings {
+		if setting.Key == "vcs.revision" {
+			// Use commit hash as version if no proper version is available
+			if len(setting.Value) >= 7 {
+				return "dev-" + setting.Value[:7]
+			}
+		}
+	}
+	return ""
+}
+
+func getDirty(info *debug.BuildInfo) bool {
+	for _, setting := range info.Settings {
+		if setting.Key == "vcs.modified" {
+			return setting.Value == "true"
+		}
+	}
+	return false
+}
+
+func getCommit(info *debug.BuildInfo) string {
+	for _, setting := range info.Settings {
+		if setting.Key == "vcs.revision" {
+			return setting.Value[:7]
+		}
+	}
+	return ""
+}
+
+// GetVersion returns the version of pulsebridge. This should be injected at build time
+// using: -ldflags="-X 'wavezync/pulse-bridge/internal/version.version=vX.X.X'".
+// If not provided, it will attempt to derive a version from VCS info.
+func GetVersion() string {
+	return version
+}
+
+// GetVersionWithBuildInfo returns detailed version information including
+// commit hash, dirty status, and Go version. This will work when built
+// within a Git checkout.
+func GetVersionWithBuildInfo() string {
+	var parts []string
+
+	// Add the main version
+	parts = append(parts, fmt.Sprintf("Version: %s", version))
+
+	// Add build metadata
+	var buildMetadata []string
+	if tag != "" {
+		buildMetadata = append(buildMetadata, tag)
+	}
+	if commit != "" {
+		buildMetadata = append(buildMetadata, commit)
+	}
+	if dirty {
+		buildMetadata = append(buildMetadata, "dirty")
+	}
+
+	if len(buildMetadata) > 0 {
+		parts = append(parts, fmt.Sprintf("Build: %s", strings.Join(buildMetadata, ".")))
+	}
+
+	// Add Go version
+	parts = append(parts, fmt.Sprintf("Go: %s", runtime.Version()))
+
+	// Add architecture
+	parts = append(parts, fmt.Sprintf("Platform: %s/%s", runtime.GOOS, runtime.GOARCH))
+
+	return strings.Join(parts, "\n")
+}