add Homebrew support; introduce version command and dynamic versioning integration

Author: ehsannm

.github/workflows/homebrew.yml

@@ -0,0 +1,72 @@
+name: Bump Homebrew formula
+
+# Updates the `ronyup` formula in clubpay/homebrew-tap whenever a new
+# `ronyup/vX.Y.Z` tag is pushed (created by scripts/bump-workspace.sh).
+#
+# Requires a repository secret HOMEBREW_TAP_TOKEN: a PAT (or fine-grained token)
+# with `contents:write` on clubpay/homebrew-tap. The default GITHUB_TOKEN cannot
+# push to another repository.
+
+on:
+  push:
+    tags:
+      - "ronyup/v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "ronyup tag to publish (e.g. ronyup/v0.4.7)"
+        required: true
+
+jobs:
+  bump:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Resolve tag and version
+        id: meta
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            TAG="${{ github.event.inputs.tag }}"
+          else
+            TAG="${GITHUB_REF#refs/tags/}"
+          fi
+          # TAG looks like "ronyup/v0.4.7"; VERSION is "0.4.7".
+          VERSION="${TAG##*/v}"
+          echo "tag=$TAG" >> "$GITHUB_OUTPUT"
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Compute source tarball checksum
+        id: sha
+        run: |
+          URL="https://github.com/${{ github.repository }}/archive/refs/tags/${{ steps.meta.outputs.tag }}.tar.gz"
+          echo "url=$URL" >> "$GITHUB_OUTPUT"
+          curl -fsSL "$URL" -o source.tar.gz
+          SHA="$(sha256sum source.tar.gz | cut -d' ' -f1)"
+          echo "sha256=$SHA" >> "$GITHUB_OUTPUT"
+
+      - name: Checkout tap
+        uses: actions/checkout@v6
+        with:
+          repository: clubpay/homebrew-tap
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          path: tap
+
+      - name: Update formula
+        run: |
+          FORMULA="tap/Formula/ronyup.rb"
+          sed -i -E "s|^  url \".*\"|  url \"${{ steps.sha.outputs.url }}\"|" "$FORMULA"
+          sed -i -E "s|^  sha256 \".*\"|  sha256 \"${{ steps.sha.outputs.sha256 }}\"|" "$FORMULA"
+          echo "----- updated formula -----"
+          cat "$FORMULA"
+
+      - name: Commit and push
+        run: |
+          cd tap
+          if git diff --quiet; then
+            echo "Formula already up to date; nothing to do."
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/ronyup.rb
+          git commit -m "ronyup ${{ steps.meta.outputs.version }}"
+          git push

README.MD

@@ -12,6 +12,14 @@ A Go toolkit for building high-performance API servers. Define your contracts on
 
 ### 1. Install the scaffolding tool
 
+With Homebrew (macOS/Linux):
+
+```bash
+brew install clubpay/tap/ronyup
+```
+
+Or with Go:
+
 ```bash
 go install github.com/clubpay/ronykit/ronyup@latest
 ```

docs/ronyup-guide.md

@@ -22,6 +22,17 @@
 
 ## Installation
 
+With [Homebrew](https://brew.sh/) (macOS/Linux):
+
+```bash
+brew install clubpay/tap/ronyup
+```
+
+This taps `clubpay/homebrew-tap` and builds `ronyup` from source (a Go toolchain
+is fetched automatically at install time). Upgrade later with `brew upgrade ronyup`.
+
+Or with the Go toolchain:
+
 ```bash
 go install github.com/clubpay/ronykit/ronyup@latest
 ```
@@ -374,7 +385,8 @@ ronyup
 ├── text             Generate translation catalogs
 ├── template         Inspect Go source for template metadata
 │   └── generate     (stub — not yet implemented)
-└── mcp              Start the MCP server
+├── mcp              Start the MCP server
+└── version          Print the ronyup version
 ```
 
 ---

ronyup/README.MD

@@ -4,6 +4,12 @@
 
 ## Install
 
+With Homebrew (macOS/Linux):
+
+```bash
+brew install clubpay/tap/ronyup
+```
+
 From the repo root:
 
 ```bash
@@ -22,6 +28,7 @@ go install github.com/clubpay/ronykit/ronyup@latest
 - `text`: extract and generate translation catalogs using `golang.org/x/text/message/pipeline`.
 - `template`: parse Go source and print package/type/function metadata (generator stub).
 - `mcp`: run `ronyup` as a stdio MCP server for AI assistants.
+- `version`: print the `ronyup` version.
 
 Running `ronyup setup` or `ronyup text` with no flags triggers an interactive TUI.
 
@@ -159,6 +166,8 @@ Feature flags:
 ## Installation
 
 ```bash
+brew install clubpay/tap/ronyup
+# or
 go install github.com/clubpay/ronykit/ronyup@latest
 ```
 

ronyup/cmd/mcp/mcp.go

@@ -35,7 +35,7 @@ var Cmd = &cobra.Command{
 
 		server := newServer(ServerConfig{
 			name:         "RonyUP",
-			version:      "v0.0.1",
+			version:      internal.Version,
 			instructions: kb.ServerInstructions,
 			executable:   exePath,
 			skeletonFS:   internal.Skeleton,

ronyup/cmd/version/version.go

@@ -0,0 +1,16 @@
+package version
+
+import (
+	"github.com/clubpay/ronykit/ronyup/internal"
+	"github.com/spf13/cobra"
+)
+
+var Cmd = &cobra.Command{
+	Use:   "version",
+	Short: "Print the ronyup version",
+	RunE: func(cmd *cobra.Command, _ []string) error {
+		cmd.Println(internal.Version)
+
+		return nil
+	},
+}

ronyup/internal/version.go

@@ -0,0 +1,7 @@
+package internal
+
+// Version is the ronyup build version. It defaults to "dev" for local builds
+// and is overridden at release time via:
+//
+//	-ldflags "-X github.com/clubpay/ronykit/ronyup/internal.Version=vX.Y.Z"
+var Version = "dev"

ronyup/main.go

@@ -5,15 +5,18 @@ import (
 	"github.com/clubpay/ronykit/ronyup/cmd/setup"
 	"github.com/clubpay/ronykit/ronyup/cmd/template"
 	"github.com/clubpay/ronykit/ronyup/cmd/text"
+	"github.com/clubpay/ronykit/ronyup/cmd/version"
+	"github.com/clubpay/ronykit/ronyup/internal"
 	"github.com/spf13/cobra"
 )
 
 var RootCmd = &cobra.Command{
-	Use: "ronyup",
+	Use:     "ronyup",
+	Version: internal.Version,
 }
 
 func main() {
-	RootCmd.AddCommand(setup.Cmd, text.Cmd, template.Cmd, mcp.Cmd)
+	RootCmd.AddCommand(setup.Cmd, text.Cmd, template.Cmd, mcp.Cmd, version.Cmd)
 
 	err := RootCmd.Execute()
 	if err != nil {