Add GitHub Actions CI/CD pipeline and release automation

- CI workflow runs tests on push to main and PRs
- Release workflow triggers on v* tags: runs tests, builds 4 platform
  binaries (linux, windows, darwin arm64/amd64) with version injected
  via ldflags, and publishes a GitHub Release with binaries attached
- Makefile gains VERSION variable and darwin build targets
- Default version string changed from hardcoded "0.1.0" to "dev"
- Add docs/releasing.md documenting the release process

Author: vector76

.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+      - name: Run tests
+        run: go test ./...

.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - name: Run tests
+        run: go test ./...
+
+      - name: Build binaries
+        run: |
+          VERSION=${GITHUB_REF_NAME#v}
+          LDFLAGS="-X 'github.com/yourorg/beads_server/internal/cli.version=${VERSION}'"
+          mkdir -p build
+          GOOS=linux   GOARCH=amd64 go build -ldflags="${LDFLAGS}" -o build/bs-linux-amd64       ./cmd/bs
+          GOOS=windows GOARCH=amd64 go build -ldflags="${LDFLAGS}" -o build/bs-windows-amd64.exe ./cmd/bs
+          GOOS=darwin  GOARCH=arm64 go build -ldflags="${LDFLAGS}" -o build/bs-darwin-arm64      ./cmd/bs
+          GOOS=darwin  GOARCH=amd64 go build -ldflags="${LDFLAGS}" -o build/bs-darwin-amd64      ./cmd/bs
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            build/bs-linux-amd64
+            build/bs-windows-amd64.exe
+            build/bs-darwin-arm64
+            build/bs-darwin-amd64

Makefile

@@ -1,21 +1,29 @@
 BINARY_NAME := bs
 BUILD_DIR := build
 SRC := ./cmd/bs
+VERSION ?= dev
+LDFLAGS := -X 'github.com/yourorg/beads_server/internal/cli.version=$(VERSION)'
 
-.PHONY: all build test clean linux windows
+.PHONY: all build test clean linux windows darwin-arm64 darwin-amd64
 
 all: test build
 
-build: linux windows
+build: linux windows darwin-arm64 darwin-amd64
 
 test:
 	go test ./...
 
 linux:
-	GOOS=linux GOARCH=amd64 go build -o $(BUILD_DIR)/$(BINARY_NAME)-linux-amd64 $(SRC)
+	GOOS=linux GOARCH=amd64 go build -ldflags="$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-amd64 $(SRC)
 
 windows:
-	GOOS=windows GOARCH=amd64 go build -o $(BUILD_DIR)/$(BINARY_NAME)-windows-amd64.exe $(SRC)
+	GOOS=windows GOARCH=amd64 go build -ldflags="$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-windows-amd64.exe $(SRC)
+
+darwin-arm64:
+	GOOS=darwin GOARCH=arm64 go build -ldflags="$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-darwin-arm64 $(SRC)
+
+darwin-amd64:
+	GOOS=darwin GOARCH=amd64 go build -ldflags="$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-darwin-amd64 $(SRC)
 
 clean:
 	rm -rf $(BUILD_DIR)

docs/releasing.md

@@ -0,0 +1,34 @@
+# Releasing
+
+Releases are triggered by pushing a git tag. GitHub Actions handles the rest: it runs tests, cross-compiles binaries for all platforms, and publishes a GitHub Release with the binaries attached.
+
+## How to cut a release
+
+```bash
+git tag v0.9.1
+git push origin v0.9.1
+```
+
+The tag name determines the version string baked into the binaries (`v0.9.1` → `bs --version` reports `0.9.1`).
+
+## What happens automatically
+
+1. CI runs `go test ./...` — if tests fail, the release is aborted
+2. Four binaries are built:
+   - `bs-linux-amd64`
+   - `bs-windows-amd64.exe`
+   - `bs-darwin-arm64` (Apple Silicon)
+   - `bs-darwin-amd64` (Intel Mac)
+3. A GitHub Release named `v0.9.1` is created with all four binaries attached and auto-generated release notes
+
+## Versioning convention
+
+Use [semantic versioning](https://semver.org): `vMAJOR.MINOR.PATCH`
+
+- `PATCH` — bug fixes, no new features (`v0.9.0` → `v0.9.1`)
+- `MINOR` — new features, backwards compatible (`v0.9.1` → `v0.10.0`)
+- `MAJOR` — breaking changes (`v0.x.x` → `v1.0.0`)
+
+## Non-release commits
+
+Ordinary commits and PRs to `main` run CI (tests only) but do **not** produce a release. Only tagged commits trigger a release build.

internal/cli/root.go

@@ -4,7 +4,7 @@ import (
 	"github.com/spf13/cobra"
 )
 
-var version = "0.1.0"
+var version = "dev"
 
 // NewRootCmd creates the root cobra command for the bs CLI.
 func NewRootCmd() *cobra.Command {