chore: server hot reload (#1791)

## Summary
Adds `air` so that the go server hot reloads on any changes to the
server code.

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: adaam2

.gitignore

@@ -19,6 +19,7 @@ junit-report.xml
 /client/sdk/docs
 /server/goa*
 /server/gram
+/server/tmp
 # Goa generates OpenAPI v2 specs with non-deterministic examples. Nothing consumes them.
 /server/gen/http/openapi.yaml
 /server/gen/http/openapi.json

.mise-tasks/start/server.sh

@@ -3,11 +3,10 @@
 #MISE dir="{{ config_root }}/server"
 #MISE description="Start up the API server"
 
-GIT_SHA=$(git rev-parse HEAD)
-
 CONFIG_ARGS=()
 if [ -f "../config.local.toml" ]; then
     CONFIG_ARGS=(--config-file ../config.local.toml)
 fi
 
-go run -ldflags="-X github.com/speakeasy-api/gram/server/cmd/gram.GitSHA=${GIT_SHA} -X goa.design/clue/health.Version=${GIT_SHA}" main.go start "${CONFIG_ARGS[@]}" "$@"
+# Use air for hot reload - args after -- are passed to the binary
+air -- start "${CONFIG_ARGS[@]}" "$@"

.mise-tasks/start/worker.sh

@@ -2,5 +2,5 @@
 #MISE dir="{{ config_root }}/server"
 #MISE description="Start up the Temporal worker"
 
-GIT_SHA=$(git rev-parse HEAD)
-go run -ldflags="-X github.com/speakeasy-api/gram/server/cmd/gram.GitSHA=${GIT_SHA} -X goa.design/clue/health.Version=${GIT_SHA}" main.go worker
+# Use air for hot reload - args after -- are passed to the binary
+air -- worker

mise.toml

@@ -25,6 +25,7 @@ uv = "0.10.4"
 yq = "4.52.4"
 hk = "1.36.0"
 pkl = "0.30.2"
+air = "1.64.5"
 
 # ℹ️ The settings below are sensible defaults for local development. When
 # deploying to production, you will want to configure these more carefully.

server/.air.toml

@@ -0,0 +1,54 @@
+# Air configuration for Gram server hot reload
+# https://github.com/air-verse/air
+
+root = "."
+tmp_dir = "tmp"
+
+[build]
+# Build command - uses mise build task
+cmd = "mise run -q build:server"
+# Binary to run after build
+bin = "./bin/gram"
+# Arguments passed to binary via command line: air -- start [args...]
+# Watch these extensions
+include_ext = ["go", "toml"]
+# Exclude these directories
+exclude_dir = ["tmp", "vendor", "testdata", ".git"]
+# Exclude these files
+exclude_file = []
+# Exclude regex patterns
+exclude_regex = ["_test\\.go$"]
+# Exclude unchanged files
+exclude_unchanged = true
+# Follow symlinks
+follow_symlink = false
+# Log file location
+log = "tmp/air.log"
+# Poll interval for watching (in ms)
+poll = false
+poll_interval = 500
+# Delay before running binary (in ms)
+delay = 500
+# Stop old binary before building new one
+stop_on_error = true
+# Send interrupt signal before killing process
+send_interrupt = true
+# Delay before sending kill signal (in ms)
+kill_delay = 500
+
+[log]
+# Show log time
+time = false
+# Only show main log
+main_only = false
+
+[color]
+# Colorize build output
+main = "magenta"
+watcher = "cyan"
+build = "yellow"
+runner = "green"
+
+[misc]
+# Clean tmp directory on exit
+clean_on_exit = true