review

commit 3cf4697eff5c068ac7d860172dc63b27463ea046
parent e38d4e87fba9f4f8c891268f89534f0f55a0d8c8
Author: Jack Mordaunt <jackmordaunt.dev@gmail.com>
Date:   Wed, 23 Sep 2026 14:58:59 -0300

review: add standard justfile

Same build, release, clean, test, install recipes as every other repository.
The go vet sidecar is its own module under sidecar/govet, so build and
release compile it with -C and install places review-vet beside review,
where the go-vet analysers look for it.

Diffstat:
M
.gitignore
 | 
1
+
A
justfile
 | 
52
++++++++++++++++++++++++++++++++++++++++++++++++++++

2 files changed, 53 insertions(+), 0 deletions(-)
diff --git a/.gitignore b/.gitignore
@@ -1 +1,2 @@
 /review
+/review-vet
diff --git a/justfile b/justfile
@@ -0,0 +1,52 @@
+# Standard recipes: build (debug), release, clean, test, install.
+# install also builds review-vet, the go vet sidecar that `go-vet/<analyzer>`
+# findings use when it sits beside review on PATH.
+
+bin := "review"
+
+# `just` alone lists the recipes.
+default:
+    @just --list --unsorted
+
+# Debug build: symbols kept, for delve and stack traces.
+build:
+    go build -o {{bin}} .
+    go build -C sidecar/govet -o ../../{{bin}}-vet .
+
+# Optimised build: stripped, reproducible paths.
+release:
+    go build -trimpath -ldflags='-s -w' -o {{bin}} .
+    go build -C sidecar/govet -trimpath -ldflags='-s -w' -o ../../{{bin}}-vet .
+
+# Vet and run the tests.
+test:
+    go vet ./...
+    go test ./...
+
+# Remove build output and the Go build cache for this module.
+clean:
+    rm -f {{bin}} {{bin}}-vet
+    go clean
+
+# Copy the release binary to a directory on PATH. An installed copy is replaced in
+# place; otherwise ~/.local/bin, ~/bin, GOBIN, GOPATH/bin, /usr/local/bin, else the
+# first writable PATH entry.
+install: release
+    #!/usr/bin/env bash
+    set -euo pipefail
+    dest=""
+    if existing=$(command -v {{bin}} 2>/dev/null) && [[ -w ${existing%/*} ]]; then
+        dest=${existing%/*}
+    fi
+    gopath=$(go env GOPATH 2>/dev/null || true); gobin=$(go env GOBIN 2>/dev/null || true)
+    for d in "$HOME/.local/bin" "$HOME/bin" "$gobin" "${gopath:+$gopath/bin}" /usr/local/bin; do
+        [[ -z $dest && -n $d && -d $d && -w $d && ":$PATH:" == *":$d:"* ]] && dest=$d
+    done
+    if [[ -z $dest ]]; then
+        IFS=: read -ra dirs <<<"$PATH"
+        for d in "${dirs[@]}"; do [[ -d $d && -w $d ]] && { dest=$d; break; }; done
+    fi
+    [[ -n $dest ]] || { echo "install: no writable directory on PATH" >&2; exit 1; }
+    install -m 755 {{bin}} "$dest/{{bin}}"
+    install -m 755 {{bin}}-vet "$dest/{{bin}}-vet"
+    echo "installed $dest/{{bin}} and $dest/{{bin}}-vet"