feat: implement update checker and release automation setup

Adds background checking for new versions via GitHub Releases API,
with caching to limit API calls. Includes version embedding at build time.

Adds GoReleaser configuration and GitHub Actions workflow for automated
release builds and publishing triggered by Git tags.

Refactors env file loading into internal/util.

Author: hmRemi

.github/workflows/release.yml

@@ -0,0 +1,31 @@
+name: Release Reflow
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  goreleaser:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.24.2'
+
+      - name: Run GoReleaser
+        uses: goreleaser/goreleaser-action@v6
+        with:
+          version: latest
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.goreleaser.yml

@@ -0,0 +1,34 @@
+project_name: reflow
+
+before:
+  hooks:
+    - go mod tidy
+
+builds:
+  - id: reflow-cli
+    main: ./main.go
+    binary: reflow
+    env:
+      - CGO_ENABLED=0
+    ldflags:
+      - -s -w
+      - -X reflow/cmd/version.version={{.Version}}
+      - -X reflow/cmd/version.repository=RevereInc/reflow
+    goos:
+      - linux
+    goarch:
+      - amd64
+      - arm64
+
+archives:
+  - id: reflow-archives
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+    format: tar.gz
+    files:
+      - README.md
+
+checksum:
+  name_template: "checksums.txt"
+
+release:
+  name_template: "Release {{.Version}}"

cmd/root.go

@@ -7,6 +7,10 @@ import (
 	"path/filepath"
 	"reflow/cmd/deploy"
 	"reflow/cmd/destroy"
+	"reflow/cmd/version"
+	"reflow/internal/update"
+	"sync"
+	"time"
 
 	"github.com/spf13/cobra"
 	"github.com/spf13/viper"
@@ -15,8 +19,10 @@ import (
 )
 
 var (
-	debug       bool
-	cfgFileBase string
+	debug              bool
+	cfgFileBase        string
+	updateCheckStarted bool
+	updateCheckMutex   sync.Mutex
 )
 
 // rootCmd represents the base command when called without any subcommands
@@ -62,6 +68,54 @@ implementing a blue-green deployment strategy to minimize downtime.`,
 				util.Log.Debug("Debug mode enabled by flag, overriding config file setting if it was false.")
 			}
 		}
+
+		// --- Perform Update Check (in background) ---
+		if cmd.Name() != "version" {
+			updateCheckMutex.Lock()
+			shouldStartCheck := !updateCheckStarted
+			if shouldStartCheck {
+				updateCheckStarted = true
+			}
+			updateCheckMutex.Unlock()
+
+			if shouldStartCheck {
+				go func() {
+					repo := version.GetRepository()
+					currentVersion := version.GetVersion()
+
+					if repo == "" || currentVersion == "dev" {
+						util.Log.Debug("Skipping update check (repo not set or dev version).")
+						return
+					}
+
+					cacheDir := filepath.Join(cfgFileBase, ".reflow-state")
+					cachePath := filepath.Join(cacheDir, update.CacheFileName)
+
+					util.Log.Debugf("Initiating background update check for repo: %s", repo)
+					result, checkErr := update.CheckForUpdate(currentVersion, repo, cachePath, 24*time.Hour)
+
+					if checkErr != nil {
+						util.Log.Debugf("Update check failed: %v", checkErr)
+						return
+					}
+
+					if result != nil && result.IsNewer {
+						fmt.Fprintf(os.Stderr, "\n---\n")
+						fmt.Fprintf(os.Stderr, "[Reflow Update Available]\n")
+						fmt.Fprintf(os.Stderr, "  Your version:  %s\n", currentVersion)
+						fmt.Fprintf(os.Stderr, "  Latest version:%s\n", result.LatestVersion)
+						fmt.Fprintf(os.Stderr, "  Release notes: %s\n", result.ReleaseURL)
+						fmt.Fprintf(os.Stderr, "  Consider updating by visiting the release page or rebuilding from source.\n")
+						fmt.Fprintf(os.Stderr, "---\n\n")
+					} else if result != nil {
+						util.Log.Debugf("Update check completed. Version '%s' is up-to-date.", currentVersion)
+					}
+				}()
+			} else {
+				util.Log.Debug("Update check already initiated for this execution.")
+			}
+		}
+
 		return nil
 	},
 }
@@ -81,6 +135,7 @@ func init() {
 	deploy.AddDeployCommand(rootCmd)
 	deploy.AddApproveCommand(rootCmd)
 	destroy.AddDestroyCommand(rootCmd)
+	version.AddVersionCommand(rootCmd)
 }
 
 // GetReflowBasePath allows other commands (like init) to access the calculated base path

cmd/version/version.go

@@ -0,0 +1,68 @@
+package version
+
+import (
+	"fmt"
+	"os"
+	rtdebug "runtime/debug"
+	"strings"
+
+	"github.com/spf13/cobra"
+)
+
+// set at build time via ldflags.
+var version = "dev"
+var repository = ""
+
+var buildInfo *rtdebug.BuildInfo
+
+func init() {
+	var ok bool
+	buildInfo, ok = rtdebug.ReadBuildInfo()
+	if !ok {
+		fmt.Fprintln(os.Stderr, "Warning: Could not read build info via runtime/debug.")
+	}
+}
+
+// AddVersionCommand defines the version command.
+func AddVersionCommand(rootCmd *cobra.Command) {
+	var versionCmd = &cobra.Command{
+		Use:   "version",
+		Short: "Print the version number and repository of Reflow",
+		Long:  `Displays the current version and source repository of the Reflow executable.`,
+		Args:  cobra.NoArgs,
+		Run: func(cmd *cobra.Command, args []string) {
+			fmt.Printf("Reflow version: %s\n", GetVersion())
+			repo := GetRepository()
+			if repo != "" {
+				fmt.Printf("Source Repository: https://github.com/%s\n", repo)
+			}
+		},
+	}
+	rootCmd.AddCommand(versionCmd)
+}
+
+// GetVersion returns the embedded version string.
+func GetVersion() string {
+	if version == "dev" && buildInfo != nil && buildInfo.Main.Version != "" && buildInfo.Main.Version != "(devel)" {
+		return buildInfo.Main.Version
+	}
+	return version
+}
+
+// GetRepository returns the embedded repository slug (owner/repo).
+func GetRepository() string {
+	if repository != "" {
+		return repository
+	}
+	if buildInfo != nil && buildInfo.Main.Path != "" {
+		pathParts := strings.Split(buildInfo.Main.Path, "/")
+		if len(pathParts) >= 3 && pathParts[0] == "github.com" {
+			repo := fmt.Sprintf("%s/%s", pathParts[1], pathParts[2])
+			return repo
+		}
+	}
+	if repository == "" {
+		return "RevereInc/reflow"
+	}
+	return ""
+}

go.mod

@@ -23,6 +23,7 @@ require (
 	github.com/go-viper/mapstructure/v2 v2.2.1 // indirect
 	github.com/gogo/protobuf v1.3.2 // indirect
 	github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 // indirect
+	github.com/hashicorp/go-version v1.7.0 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 // indirect
 	github.com/kevinburke/ssh_config v1.2.0 // indirect

go.sum

@@ -49,6 +49,8 @@ github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q=
 github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q=
 github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 h1:f+oWsMOmNPc8JmEHVZIycC7hBoQxHH9pNKQORJNozsQ=
 github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8/go.mod h1:wcDNUvekVysuuOpQKo3191zZyTpiI6se1N1ULghS0sw=
+github.com/hashicorp/go-version v1.7.0 h1:5tqGy27NaOTB8yJKUZELlFAS/LTKJkrmONwQKeRZfjY=
+github.com/hashicorp/go-version v1.7.0/go.mod h1:fltr4n8CU8Ke44wwGCBoEymUuxUHl09ZGVZPK5anwXA=
 github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
 github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
 github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 h1:BQSFePA1RWJOlocH6Fxy8MmwDt+yVQYULKfN0RoTN8A=

internal/orchestrator/approve.go

@@ -117,7 +117,7 @@ func ApproveProd(ctx context.Context, reflowBasePath, projectName string) (err e
 	}
 
 	util.Log.Debugf("Loading environment variables from file: %s", envFilePath)
-	envVars, err := loadEnvFile(envFilePath)
+	envVars, err := util.LoadEnvFile(envFilePath)
 	if err != nil {
 		return fmt.Errorf("failed to load prod environment variables: %w", err)
 	}

internal/orchestrator/deploy.go

@@ -1,7 +1,6 @@
 package orchestrator
 
 import (
-	"bufio"
 	"context"
 	"fmt"
 	"os"
@@ -170,7 +169,7 @@ func DeployTest(ctx context.Context, reflowBasePath, projectName, commitIsh stri
 		envFilePath = filepath.Join(repoPath, projCfg.Environments["test"].EnvFile)
 	}
 
-	envVars, err := loadEnvFile(envFilePath)
+	envVars, err := util.LoadEnvFile(envFilePath)
 	if err != nil {
 		return fmt.Errorf("failed to load environment variables: %w", err)
 	}
@@ -297,50 +296,3 @@ func DeployTest(ctx context.Context, reflowBasePath, projectName, commitIsh stri
 
 	return nil
 }
-
-// loadEnvFile loads environment variables from a specified file.
-func loadEnvFile(filePath string) ([]string, error) {
-	var vars []string
-	if filePath == "" {
-		util.Log.Debug("No env file path specified.")
-		return vars, nil
-	}
-
-	file, err := os.Open(filePath)
-	if err != nil {
-		if os.IsNotExist(err) {
-			util.Log.Warnf("Environment file not found at %s, continuing without it.", filePath)
-			return vars, nil
-		}
-		return nil, fmt.Errorf("failed to open env file %s: %w", filePath, err)
-	}
-	defer func(file *os.File) {
-		err := file.Close()
-		if err != nil {
-			util.Log.Errorf("Error closing env file %s: %v", filePath, err)
-		} else {
-			util.Log.Debugf("Closed env file %s successfully.", filePath)
-		}
-	}(file)
-
-	scanner := bufio.NewScanner(file)
-	lineNumber := 0
-	for scanner.Scan() {
-		lineNumber++
-		line := strings.TrimSpace(scanner.Text())
-		if line == "" || strings.HasPrefix(line, "#") {
-			continue
-		}
-		if !strings.Contains(line, "=") {
-			util.Log.Warnf("Skipping invalid line %d in env file %s: Missing '='", lineNumber, filePath)
-			continue
-		}
-		vars = append(vars, line)
-	}
-
-	if err := scanner.Err(); err != nil {
-		return nil, fmt.Errorf("error reading env file %s: %w", filePath, err)
-	}
-	util.Log.Debugf("Loaded %d variables from %s", len(vars), filePath)
-	return vars, nil
-}