feat: add ability to specify Git repos and Homebrew packages

Author: eywalker

.github/workflows/release.yml

@@ -19,7 +19,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v5
         with:
-          go-version: "1.24"
+          go-version: "1.25"
 
       - name: Run tests
         run: go test -v ./...
@@ -35,7 +35,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v5
         with:
-          go-version: "1.24"
+          go-version: "1.25"
 
       - name: Build binaries for all platforms
         run: |
@@ -57,6 +57,10 @@ jobs:
           echo "Building Linux amd64..."
           GOOS=linux GOARCH=amd64 go build -ldflags="${LDFLAGS}" -o dist/devenv-linux-amd64 ./cmd/devenv
 
+          # Linux arm64
+          echo "Building Linux arm64..."
+          GOOS=linux GOARCH=arm64 go build -ldflags="${LDFLAGS}" -o dist/devenv-linux-arm64 ./cmd/devenv
+
           # macOS amd64 (Intel)
           echo "Building macOS amd64..."
           GOOS=darwin GOARCH=amd64 go build -ldflags="${LDFLAGS}" -o dist/devenv-darwin-amd64 ./cmd/devenv
@@ -72,14 +76,21 @@ jobs:
           echo "✅ All binaries built successfully"
           ls -lh dist/
 
+      - name: Generate checksums
+        run: |
+          cd dist
+          sha256sum * > checksums.txt
+
       - name: Create Release
         uses: softprops/action-gh-release@v2
         with:
           files: |
             dist/devenv-linux-amd64
+            dist/devenv-linux-arm64
             dist/devenv-darwin-amd64
             dist/devenv-darwin-arm64
             dist/devenv-windows-amd64.exe
+            dist/checksums.txt
           generate_release_notes: true
           draft: false
           prerelease: false

internal/config/types.go

@@ -17,6 +17,9 @@ type BaseConfig struct {
 	// Package management
 	Packages PackageConfig `yaml:"packages,omitempty"`
 
+	// Git repos to be cloned
+	GitRepos []GitRepo `yaml:"gitRepos,omitempty" validate:"dive"`
+
 	// Storage configuration
 	Volumes []VolumeMount `yaml:"volumes,omitempty" validate:"dive"`
 
@@ -68,9 +71,17 @@ type GitConfig struct {
 type PackageConfig struct {
 	Python []string `yaml:"python,omitempty" validate:"dive,min=1"`
 	APT    []string `yaml:"apt,omitempty" validate:"dive,min=1"`
+	Brew   []string `yaml:"brew,omitempty" validate:"dive,min=1"`
 	// Consider adding other package managers such as NPM, Yarn, etc.
 }
 
+type GitRepo struct {
+	URL        string `yaml:"url" validate:"required,min=1,url"`
+	Branch     string `yaml:"branch,omitempty" validate:"omitempty,min=1"`
+	CommitHash string `yaml:"commitHash,omitempty" validate:"omitempty,min=1"`
+	Directory  string `yaml:"directory,omitempty" validate:"omitempty,min=1,filepath"`
+}
+
 // ResourceConfig represents resource allocation
 type ResourceConfig struct {
 	CPU     any    `yaml:"cpu,omitempty" validate:"omitempty,k8s_cpu"`
@@ -112,7 +123,9 @@ func NewBaseConfigWithDefaults() BaseConfig {
 		Packages: PackageConfig{
 			Python: []string{}, // Empty slice - no default packages
 			APT:    []string{}, // Empty slice - no default packages
+			Brew:   []string{}, // Empty slice - no default packages
 		},
+		GitRepos:        []GitRepo{},     // Empty slice - no default git repositories
 		Volumes:         []VolumeMount{}, // Empty slice - no default volumes
 		Namespace:       "devenv",        // Default namespace
 		EnvironmentName: "development",   // Default environment name

internal/config/validation.go

@@ -56,6 +56,7 @@ func init() {
 	if err := validate.RegisterValidation("k8s_memory", validateKubernetesMemory); err != nil {
 		panic(fmt.Errorf("register validator k8s_memory: %w", err))
 	}
+	validate.RegisterStructValidation(validateGitRepo, GitRepo{})
 }
 
 // validateSSHKeys implements the "ssh_keys" tag.
@@ -79,6 +80,17 @@ func validateSSHKeys(fl validator.FieldLevel) bool {
 	return true
 }
 
+// validateGitRepo implements the "git_repo" tag.
+// Ensures that if both Branch and CommitHash are specified, an error is raised.
+func validateGitRepo(sl validator.StructLevel) {
+	repo := sl.Current().Interface().(GitRepo)
+	// Both Branch and CommitHash cannot be specified simultaneously.
+	if repo.Branch != "" && repo.CommitHash != "" {
+		sl.ReportError(repo.Branch, "branch", "Branch", "branch_commit_conflict", "")
+		sl.ReportError(repo.CommitHash, "commitHash", "CommitHash", "branch_commit_conflict", "")
+	}
+}
+
 // validateKubernetesCPU implements the "k8s_cpu" tag for *raw* CPU fields.
 // Accepts:
 //   - Strings: "", "unlimited", plain number ("2", "2.5"), or millicores ("500m")
@@ -182,6 +194,13 @@ func ValidateDevEnvConfig(config *DevEnvConfig) error {
 		return err // "memory must be >= 0"
 	}
 
+	// If GitRepos are specified, ensure that hash & branch are not both specified.
+	for i, repo := range config.GitRepos {
+		if repo.CommitHash != "" && repo.Branch != "" {
+			return fmt.Errorf("gitRepos[%d]: commitHash and branch cannot both be specified", i)
+		}
+	}
+
 	if config.Resources.GPU < 0 {
 		return fmt.Errorf("gpu must be >= 0")
 	}

internal/templates/template_files/system/manifests/namespace.tmpl

@@ -2,6 +2,6 @@ apiVersion: v1
 kind: Namespace
 metadata:
   name: {{.Namespace}}
-  environment: {{.EnvironmentName}}
   annotations:
-    description: "Namespace for DevENV resources"
+    description: "Namespace for DevENV resources"
+    environment: {{.EnvironmentName}}