build: add make targets for build test and install

Author: paoloanzn

Makefile

@@ -0,0 +1,33 @@
+SHELL := /bin/sh
+
+GO ?= go
+BINARY ?= flare-edge-cli
+PACKAGE ?= ./cmd/flare-edge-cli
+BINDIR ?= bin
+BUILD_OUTPUT := $(BINDIR)/$(BINARY)
+
+# Prefer standard user-local bin directories and fall back to ~/.local/bin.
+INSTALL_DIR ?= $(shell \
+	if [ -n "$$XDG_BIN_HOME" ]; then \
+		printf '%s\n' "$$XDG_BIN_HOME"; \
+	elif [ -d "$$HOME/.local/bin" ]; then \
+		printf '%s\n' "$$HOME/.local/bin"; \
+	elif [ -d "$$HOME/bin" ]; then \
+		printf '%s\n' "$$HOME/bin"; \
+	else \
+		printf '%s\n' "$$HOME/.local/bin"; \
+	fi)
+
+.PHONY: build test install
+
+build:
+	@mkdir -p "$(BINDIR)"
+	$(GO) build -o "$(BUILD_OUTPUT)" $(PACKAGE)
+
+test:
+	$(GO) test ./...
+
+install: build
+	@mkdir -p "$(INSTALL_DIR)"
+	install -m 0755 "$(BUILD_OUTPUT)" "$(INSTALL_DIR)/$(BINARY)"
+	@printf 'Installed %s to %s\n' "$(BINARY)" "$(INSTALL_DIR)"

README.md

@@ -74,10 +74,18 @@ The implementation is intentionally biased toward agent use:
 Build the binary from the repository root:
 
 ```bash
-go build
+make build
 ```
 
-That produces a local `./flare-edge-cli` binary.
+That produces a local `./bin/flare-edge-cli` binary.
+
+Install it into a user-local bin directory:
+
+```bash
+make install
+```
+
+The install target prefers `XDG_BIN_HOME` when set, then an existing `~/.local/bin`, then `~/bin`, and otherwise creates `~/.local/bin`. You can override the destination explicitly with `make install INSTALL_DIR=/path/to/bin`.
 
 You can also run it directly during development:
 
@@ -465,6 +473,9 @@ Attach a route or custom domain:
 Useful local commands:
 
 ```bash
+make build
+make test
+make install
 go test ./...
 go vet ./...
 go test -race ./...