Merge pull request #6 from maphew:auto-release

 automated build and release infrastructure for beady. let's find out if this works!

Author: maphew

.beads/issues.jsonl

@@ -35,4 +35,11 @@
 {"id":"beady-5","content_hash":"6a2f7cc5014cb2480a54c9acd9f26e16ccad8a47773e88655db48b9638fd7445","title":"add feature: live reload","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-10-23T02:50:14.475464102-07:00","updated_at":"2025-10-26T19:44:25.3404749-07:00","closed_at":"2025-10-23T03:25:18.353531264-07:00"}
 {"id":"beady-7","content_hash":"5b2e3098e3a7f4363fc8f2d647f97a3ec5b9f8a4525fd406745fd8645dbe82a2","title":"missing templates causing panic in dev mode","description":"","status":"closed","priority":0,"issue_type":"bug","created_at":"2025-10-24T05:38:00.486024544-07:00","updated_at":"2025-10-26T19:44:25.3450313-07:00","closed_at":"2025-10-24T05:42:56.941119818-07:00"}
 {"id":"beady-8","content_hash":"040645dd42eef87c67cb0210f4272e57a3f3322614c9214cd8b924f45abdb5af","title":"why template \u0026 static in root and in cmd/bd-ui? which location is best practice?","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-10-24T05:50:56.38010406-07:00","updated_at":"2025-10-26T19:44:25.34703-07:00","closed_at":"2025-10-24T05:53:33.7105026-07:00"}
+{"id":"beady-89d5","content_hash":"c2bd99fd4d23f72efc351782e11208108b7852f2fffd7152e2a135fe339c1087","title":"feat: if port conflict on launch, check if is used by beady, when yes issue api shutdown command and then re-attempt launch. if no use next available port","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-10-31T15:00:46.6322697-07:00","updated_at":"2025-10-31T15:00:46.6322697-07:00"}
 {"id":"beady-9","content_hash":"614924ca786cdd912f1087f9daeecdae4841130b69fa4aafabe3db3db3bbfdd4","title":"Fix asset paths in main.go after restructure","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-10-24T06:08:53.974194168-07:00","updated_at":"2025-10-26T19:44:25.3495258-07:00","closed_at":"2025-10-24T06:09:05.155951649-07:00"}
+{"id":"beady-d424","content_hash":"3c0d46785080729d9f66add2510bd9e18e0fd53fa38d83473865a0e1e82182f1","title":"infra: auto-build and create release packages on github","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-10-31T14:23:57.7231922-07:00","updated_at":"2025-10-31T14:23:57.7231922-07:00"}
+{"id":"beady-d424.1","content_hash":"51d64df4a67783df2b4d6bf9f281e5cafd5f7181000c3e60135ef590e036fa64","title":"Create .goreleaser.yml configuration for multi-platform builds","description":"Configure GoReleaser to build beady for Windows (amd64, arm64), Linux (amd64, arm64, 386), and macOS (amd64, arm64). Should respect the embedded assets pattern.","status":"closed","priority":2,"issue_type":"task","created_at":"2025-10-31T15:37:29.8839718-07:00","updated_at":"2025-10-31T15:42:53.5700649-07:00","closed_at":"2025-10-31T15:42:53.5700649-07:00"}
+{"id":"beady-d424.2","content_hash":"cb66dd79c9d02902135b061b4b86a6fe0e2b0e10286c047ed67b61010facc301","title":"Create GitHub Actions workflow for automated releases","description":"Set up .github/workflows/release.yml that triggers on tag push, runs GoReleaser, and creates GitHub releases with binaries attached","status":"closed","priority":2,"issue_type":"task","created_at":"2025-10-31T15:37:34.8777658-07:00","updated_at":"2025-10-31T15:42:57.6983142-07:00","closed_at":"2025-10-31T15:42:57.6983142-07:00"}
+{"id":"beady-d424.3","content_hash":"add3af0663ea6d47d79a43b3730f6eb2ba4cf7261379c053eaad96ecc33dfeaa","title":"Update README.md with new release process and download instructions","description":"Document how to download pre-built binaries from GitHub releases, update release process to use tags + GitHub Actions instead of manual go install, and add badges for latest release","status":"closed","priority":2,"issue_type":"task","created_at":"2025-10-31T15:37:40.2752632-07:00","updated_at":"2025-10-31T15:43:40.5479827-07:00","closed_at":"2025-10-31T15:43:40.5479827-07:00"}
+{"id":"beady-d424.4","content_hash":"191c763aa4cc65af2a6ad750233cbcdb3b369fc25a3cb399773ea98c593148ed","title":"Test release workflow with test tag","description":"Create a test tag (e.g., v0.0.1-test) to verify the GitHub Actions workflow runs correctly, builds all platforms, and creates a draft release","status":"open","priority":2,"issue_type":"task","created_at":"2025-10-31T15:37:44.9441448-07:00","updated_at":"2025-10-31T15:37:44.9441448-07:00"}
+{"id":"beady-da50","content_hash":"1e282ae329adc6a557be4aeb938ced5ac6fca66761e3e0b504a5d63f6116968c","title":"feat: add self-update to download and install latest binary. See go-update, https://github.com/inconshreveable/go-update","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-10-31T14:23:05.7770007-07:00","updated_at":"2025-10-31T14:23:05.7770007-07:00"}

.claude/settings.local.json

@@ -26,7 +26,8 @@
       "Bash(git pull:*)",
       "Bash(git checkout:*)",
       "Bash(.binbeady.exe --dev)",
-      "Bash(git log:*)"
+      "Bash(git log:*)",
+      "Bash(where:*)"
     ],
     "deny": [],
     "ask": []

.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  release:
+    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'
+          cache: true
+
+      - name: Install build dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y gcc-multilib gcc-mingw-w64
+
+      - name: Run GoReleaser
+        uses: goreleaser/goreleaser-action@v6
+        with:
+          distribution: goreleaser
+          version: '~> v2'
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: release-artifacts
+          path: |
+            dist/*.tar.gz
+            dist/*.zip
+            dist/checksums.txt

.goreleaser.yml

@@ -0,0 +1,127 @@
+# GoReleaser configuration for beady
+# See https://goreleaser.com for documentation
+
+version: 2
+
+before:
+  hooks:
+    # Ensure dependencies are up to date
+    - go mod tidy
+    # Run tests before building
+    - go test ./...
+
+builds:
+  - id: beady
+    main: ./cmd/beady
+    binary: beady
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
+    goarch:
+      - amd64
+      - arm64
+      - "386"
+    # Exclude invalid combinations
+    ignore:
+      - goos: darwin
+        goarch: "386"
+      - goos: windows
+        goarch: arm64  # Windows ARM64 support is experimental
+    # Build flags to ensure embedded assets are included
+    flags:
+      - -trimpath
+    ldflags:
+      - -s -w
+      - -X github.com/maphew/beady/cmd/beady.version={{.Version}}
+      - -X github.com/maphew/beady/cmd/beady.commit={{.Commit}}
+      - -X github.com/maphew/beady/cmd/beady.date={{.Date}}
+
+archives:
+  - id: beady-archive
+    format: tar.gz
+    name_template: >-
+      {{ .ProjectName }}_
+      {{- .Version }}_
+      {{- title .Os }}_
+      {{- if eq .Arch "amd64" }}x86_64
+      {{- else if eq .Arch "386" }}i386
+      {{- else }}{{ .Arch }}{{ end }}
+      {{- if .Arm }}v{{ .Arm }}{{ end }}
+    format_overrides:
+      - goos: windows
+        format: zip
+    files:
+      - README.md
+      - LICENSE
+      - CLAUDE.md
+
+checksum:
+  name_template: 'checksums.txt'
+
+snapshot:
+  version_template: "{{ incpatch .Version }}-next"
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - '^docs:'
+      - '^test:'
+      - '^chore:'
+      - '^ci:'
+      - Merge pull request
+      - Merge branch
+
+release:
+  github:
+    owner: maphew
+    name: beady
+  draft: false
+  prerelease: auto
+  mode: replace
+  header: |
+    ## Beady {{.Tag}}
+
+    A web UI for the [beads](https://github.com/steveyegge/beads) issue tracker.
+
+    ### Installation
+
+    Download the appropriate binary for your platform below, extract it, and add it to your PATH.
+
+    Or install via Go:
+    ```bash
+    go install github.com/maphew/beady/cmd/beady@{{.Tag}}
+    ```
+  footer: |
+    ---
+
+    **Full Changelog**: https://github.com/maphew/beady/compare/{{.PreviousTag}}...{{.Tag}}
+
+    ## What's Next
+
+    See the [beady issue tracker](https://github.com/maphew/beady/issues) for upcoming features.
+
+# Uncomment to publish to Homebrew tap (requires separate tap repository)
+# brews:
+#   - repository:
+#       owner: maphew
+#       name: homebrew-tap
+#     homepage: https://github.com/maphew/beady
+#     description: A web UI for the beads issue tracker
+#     license: MIT
+
+# Uncomment to build Docker images
+# dockers:
+#   - image_templates:
+#       - "ghcr.io/maphew/beady:{{ .Version }}"
+#       - "ghcr.io/maphew/beady:latest"
+#     dockerfile: Dockerfile
+#     build_flag_templates:
+#       - "--pull"
+#       - "--label=org.opencontainers.image.created={{.Date}}"
+#       - "--label=org.opencontainers.image.title={{.ProjectName}}"
+#       - "--label=org.opencontainers.image.revision={{.FullCommit}}"
+#       - "--label=org.opencontainers.image.version={{.Version}}"

README.md

@@ -46,27 +46,36 @@ All write operations are performed by executing the `bd` CLI, ensuring guarantee
 
 ### Prerequisites
 
-- Go 1.21 or later
-- A beads database file
 - **bd CLI** in PATH (required for write operations) - install from [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
+- A beads database file (will be auto-discovered from `.beads/` directory)
 
-### Quick install from Git
+### Download Pre-built Binaries (Recommended)
+
+Download the latest release for your platform from [GitHub Releases](https://github.com/maphew/beady/releases):
+
+- **Windows**: `beady_VERSION_Windows_x86_64.zip` (or `i386` for 32-bit)
+- **macOS**: `beady_VERSION_Darwin_x86_64.tar.gz` (or `arm64` for Apple Silicon)
+- **Linux**: `beady_VERSION_Linux_x86_64.tar.gz` (or `arm64`, `i386`)
+
+Extract the binary and add it to your PATH.
+
+### Install via Go
 
 Install the latest release:
 
 ```bash
-go install github.com/maphew/beads-ui/cmd/beady@latest
+go install github.com/maphew/beady/cmd/beady@latest
 ```
 
-Or install the latest development version from main branch:
+Or install a specific version:
 
 ```bash
-go install github.com/maphew/beads-ui/cmd/beady@main
+go install github.com/maphew/beady/cmd/beady@v1.0.0
 ```
 
 This will install the `beady` binary to your `$GOPATH/bin` (usually `~/go/bin`).
 
-### Building from source
+### Building from Source
 
 1. Clone this repository:
 ```bash
@@ -194,11 +203,27 @@ All write endpoints accept JSON request bodies with a `username` field for attri
 
 ### Releasing
 
-This project follows semantic versioning. To release a new version:
-
-1. Update the version in any relevant files (if needed)
-2. Create and push a git tag with the version (e.g., `git tag v1.0.0 && git push origin v1.0.0`)
-3. This will make the version available via `go install ...@latest`
+This project uses [GoReleaser](https://goreleaser.com/) with GitHub Actions for automated releases. To create a new release:
+
+1. Ensure all changes are committed and pushed to `main` branch
+2. Create and push a version tag following semantic versioning:
+   ```bash
+   git tag v1.0.0
+   git push origin v1.0.0
+   ```
+3. GitHub Actions will automatically:
+   - Build binaries for all platforms (Linux, Windows, macOS)
+   - Generate checksums
+   - Create a GitHub release with all artifacts
+   - Make the version available via `go install ...@latest`
+
+The release will include:
+- Multi-platform binaries (amd64, arm64, 386)
+- Archives (`.tar.gz` for Unix, `.zip` for Windows)
+- Checksums for verification
+- Automated changelog from commits
+
+**Testing a release**: To test the release process without creating an official release, push a tag with a `-test` suffix (e.g., `v0.0.1-test`).
 
 ## Dependencies
 

cmd/beady/main.go

@@ -28,6 +28,13 @@ import (
 	"github.com/steveyegge/beads"
 )
 
+// Build information set by GoReleaser via ldflags
+var (
+	version = "dev"
+	commit  = "none"
+	date    = "unknown"
+)
+
 var embedFS = beady.FS
 
 var tmplFS fs.FS
@@ -109,23 +116,31 @@ var store beads.Storage
 var devMode bool
 
 var help = flag.Bool("help", false, "Show help")
+var showVersion = flag.Bool("version", false, "Show version information")
 
 var detectedUsername string
 
 var srv *http.Server
 
 func printUsage() {
-	fmt.Fprintf(os.Stderr, "Usage: %s [database-path] [port] [-d] [--help]\n", os.Args[0])
+	fmt.Fprintf(os.Stderr, "Usage: %s [database-path] [port] [-d] [--help] [--version]\n", os.Args[0])
 	fmt.Fprintf(os.Stderr, "Options:\n")
 	fmt.Fprintf(os.Stderr, "  -d, --dev       Enable development mode with live reload\n")
 	fmt.Fprintf(os.Stderr, "  -h, --help      Show help\n")
+	fmt.Fprintf(os.Stderr, "  --version       Show version information\n")
 	fmt.Fprintf(os.Stderr, "Examples:\n")
 	fmt.Fprintf(os.Stderr, "  %s                    # autodiscover database\n", os.Args[0])
 	fmt.Fprintf(os.Stderr, "  %s .beads/name.db   # specify database path\n", os.Args[0])
 	fmt.Fprintf(os.Stderr, "  %s .beads/name.db 8080  # specify path and port\n", os.Args[0])
 	fmt.Fprintf(os.Stderr, "  %s -d .beads/name.db 8080  # enable live reload\n", os.Args[0])
 }
 
+func printVersion() {
+	fmt.Printf("beady %s\n", version)
+	fmt.Printf("  commit: %s\n", commit)
+	fmt.Printf("  built:  %s\n", date)
+}
+
 var upgrader = websocket.Upgrader{
 	CheckOrigin: func(r *http.Request) bool { return true }, // Allow all origins for dev
 }
@@ -261,6 +276,10 @@ func main() {
 		flag.Usage()
 		os.Exit(0)
 	}
+	if *showVersion {
+		printVersion()
+		os.Exit(0)
+	}
 
 	// Detect username for attribution
 	detectedUsername = detectUsername()