Configure 'release' (#92)

* Configure GoReleaser
* Configure GHA for binary release
* Update Makefile (mostly for linker flags)
* Update 'version' and template in base command and root

Author: peteski22

.github/workflows/release-binary.yaml

@@ -0,0 +1,32 @@
+name: Release Binary
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  goreleaser:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0
+
+      - name: Set up Go (from go.mod)
+        uses: actions/setup-go@d35c59abb061a4a6fb18e82ac0862c26744d6ab5 # v5.5.0
+        with:
+          go-version-file: go.mod
+
+      - name: Run GoReleaser
+        uses: goreleaser/goreleaser-action@9c156ee8a17a598857849441385a2041ef570552 # v6.3.0
+        with:
+          distribution: goreleaser
+          version: latest
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.goreleaser.yaml

@@ -0,0 +1,56 @@
+# yaml-language-server: $schema=https://goreleaser.com/static/schema.json
+# vim: set ts=2 sw=2 tw=0 fo=cnqoj
+
+version: 2
+
+before:
+  hooks:
+    - go mod tidy
+    - go generate ./...
+
+builds:
+  - env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
+    goarch:
+      - amd64
+      - arm64
+    main: .
+    binary: mcpd
+    ldflags:
+      - -s -w  # Strip debug info and symbol table
+      - -X 'github.com/mozilla-ai/mcpd/v2/internal/cmd.version={{.Version}}'  # Bake in version
+      - -X 'github.com/mozilla-ai/mcpd/v2/internal/cmd.commit={{.Commit}}'    # Bake in commit hash
+      - -X 'github.com/mozilla-ai/mcpd/v2/internal/cmd.date={{.Date}}'        # Bake in build date
+    flags:
+      - -trimpath  # Remove file system paths from binary
+archives:
+  - formats: [tar.gz]
+    # name template makes the OS and Arch compatible with the results of `uname`.
+    name_template: >-
+      {{ .ProjectName }}_
+      {{- title .Os }}_
+      {{- if eq .Arch "amd64" }}x86_64
+      {{- else if eq .Arch "386" }}i386
+      {{- else }}{{ .Arch }}{{ end }}
+      {{- if .Arm }}v{{ .Arm }}{{ end }}
+    # use zip for windows archives
+    format_overrides:
+      - goos: windows
+        formats: [zip]
+
+changelog:
+  disable: true
+
+release:
+  replace_existing_draft: true
+  draft: true
+  prerelease: auto
+  footer: >-
+
+    ---
+
+    Released by [GoReleaser](https://github.com/goreleaser/goreleaser).

Makefile

@@ -1,4 +1,4 @@
-.PHONY: build clean docs docs-cli docs-local docs-nav install test uninstall
+.PHONY: build build-dev build-linux build-linux-arm64 clean docs docs-cli docs-local docs-nav install local-down local-up test uninstall
 
 MODULE_PATH := github.com/mozilla-ai/mcpd/v2
 
@@ -13,42 +13,58 @@ INSTALL_DIR := /usr/local/bin
 #   - e.g., "dev" if git is not available or no commits yet
 VERSION := $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
 
-# Linker flags for injecting version
+# Get commit hash and date
+COMMIT := $(shell git rev-parse HEAD 2>/dev/null || echo "unknown")
+DATE := $(shell date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# Linker flags for injecting version and optimizations
 # The path is MODULE_PATH/package.variableName
-LDFLAGS := -X '$(MODULE_PATH)/internal/cmd.version=$(VERSION)'
+LDFLAGS := -s -w -X '$(MODULE_PATH)/internal/cmd.version=$(VERSION)' \
+				-X '$(MODULE_PATH)/internal/cmd.commit=$(COMMIT)' \
+				-X '$(MODULE_PATH)/internal/cmd.date=$(DATE)'
+
+# Build flags for optimization
+BUILDFLAGS := -trimpath
 
 test:
 	go test ./...
 
 build:
-	@echo "building mcpd (with flags: ${LDFLAGS})..."
-	@go build -o mcpd -ldflags="${LDFLAGS}" .
+	@echo "building mcpd (version: $(VERSION), commit: $(COMMIT))..."
+	@go build $(BUILDFLAGS) -o mcpd -ldflags="$(LDFLAGS)" .
 
 build-linux:
-	@echo "building mcpd for amd64/linux (with flags: ${LDFLAGS})..."
-	@GOOS=linux GOARCH=amd64 go build -o mcpd -ldflags="${LDFLAGS}" .
+	@echo "building mcpd for amd64/linux (version: $(VERSION), commit: $(COMMIT))..."
+	@GOOS=linux GOARCH=amd64 go build $(BUILDFLAGS) -o mcpd -ldflags="$(LDFLAGS)" .
 
 build-linux-arm64:
-	@echo "building mcpd for arm64/linux (with flags: ${LDFLAGS})..."
-	@GOOS=linux GOARCH=arm64 go build -o mcpd -ldflags="${LDFLAGS}" .
+	@echo "building mcpd for arm64/linux (version: $(VERSION), commit: $(COMMIT))..."
+	@GOOS=linux GOARCH=arm64 go build $(BUILDFLAGS) -o mcpd -ldflags="$(LDFLAGS)" .
+
+# For development builds without optimizations (for debugging)
+build-dev:
+	@echo "building mcpd for development (version: $(VERSION), commit: $(COMMIT))..."
+	@go build -o mcpd -ldflags="-X '$(MODULE_PATH)/internal/cmd.version=$(VERSION)' \
+		-X '$(MODULE_PATH)/internal/cmd.commit=$(COMMIT)' \
+		-X '$(MODULE_PATH)/internal/cmd.date=$(DATE)'" .
 
 install: build
 	@# Copy the executable to the install directory
 	@# Requires sudo if INSTALL_DIR is a system path like /usr/local/bin
+	@echo "installing mcpd to $(INSTALL_DIR)..."
 	@cp mcpd $(INSTALL_DIR)/mcpd
-	@echo "mcpd installed to $(INSTALL_DIR)/mcpd"
+	@chmod +x $(INSTALL_DIR)/mcpd
 
 clean:
 	@# Remove the built executable and any temporary files
+	@echo "cleaning up local build artifacts..."
 	@rm -f mcpd # The executable itself
-	@# Add any other build artifacts here if they accumulate (e.g., cache files)
-	@echo "build artifacts cleaned"
 
 uninstall:
 	@# Remove the installed executable from the system
 	@# Requires sudo if INSTALL_DIR is a system path
+	@echo "uninstalling mcpd from $(INSTALL_DIR)..."
 	@rm -f $(INSTALL_DIR)/mcpd
-	@echo "mcpd uninstalled from $(INSTALL_DIR)/mcpd"
 
 # Runs MkDocs locally
 docs: docs-local

cmd/root.go

@@ -46,9 +46,12 @@ func NewRootCmd(c *RootCmd) (*cobra.Command, error) {
 			"define their agent projects, and manage MCP server dependencies",
 		SilenceUsage:  true,
 		SilenceErrors: true,
-		Version:       cmd.Version(),
 	}
 
+	// Manually set the version template to prevent duplication in output.
+	rootCmd.SetVersionTemplate("{{.Version}}\n")
+	rootCmd.Version = cmd.Version()
+
 	// Configure app specific global flags that will appear on sub-commands.
 	if err := flags.InitFlags(rootCmd.PersistentFlags()); err != nil {
 		return nil, err

internal/cmd/basecmd.go

@@ -13,13 +13,17 @@ import (
 	"github.com/mozilla-ai/mcpd/v2/internal/runtime"
 )
 
-// version should not be moved/modified without consulting the Makefile,
-// as the path to this var is set on the LDFLAGS variable in the script.
-var version = "dev" // Set at build time using -ldflags
+var (
+	// version should not be moved/modified without consulting the Makefile and GoReleaser config,
+	// as the path to this var is set on the LDFLAGS variable in the script.
+	version = "dev"     // Set via ldflags
+	commit  = "unknown" // Set via ldflags
+	date    = "unknown" // Set via ldflags
+)
 
 // Version is used by other packages to retrieve the build version of mcpd.
 func Version() string {
-	return version
+	return fmt.Sprintf("mcpd %s (%s), built %s", version, commit, date)
 }
 
 // AppName returns the name of the mcpd application.