feat: standalone build + systemd install (Arch Linux)

bin/build: compiles standalone binaries (dispatch-server + dispatch CLI)
via bun build --compile, builds the frontend static bundle with
VITE_HTTP_PORT=24991 + VITE_WS_PORT=24990, copies to dist/web/.

bin/install: installs binaries to /usr/bin/, frontend to
/usr/share/dispatch/web/, systemd service to /etc/systemd/system/,
config to /etc/dispatch/env, data dirs to /var/lib/dispatch/ +
/var/log/dispatch/. Enables + starts the dispatch systemd service.
Supports --uninstall and --no-build flags.

systemd/dispatch.service: Type=simple, reads /etc/dispatch/env,
restarts on failure, logs to journald.

systemd/dispatch.env: template config (ports 24991 HTTP + 24990 WS,
DISPATCH_WEB_DIR, API key, data paths).

transport-http: optional webDir static file serving — unmatched GET
requests fall through to Bun.file() serving with SPA index.html
fallback. Gated on DISPATCH_WEB_DIR env var (backward compatible).

2 files changed, 175 insertions, 0 deletions

diff --git a/bin/build b/bin/build
new file mode 100755
index 0000000..0517af5
--- /dev/null
+++ b/bin/build
@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# bin/build — compile the backend + CLI binaries and the frontend static bundle.
+#
+# Output:
+#   dist/dispatch-server   — standalone backend binary (Bun compile)
+#   dist/dispatch          — standalone CLI binary (Bun compile)
+#   dist/web/              — built frontend static files (vite build)
+#
+# The frontend is built with VITE_HTTP_PORT=24991 + VITE_WS_PORT=24990 so the
+# bundle talks to the backend on :24991 (HTTP) and :24990 (WS) at runtime.
+# The backend serves the frontend from DISPATCH_WEB_DIR (set in the systemd env).
+#
+# Usage: bin/build [--no-frontend]   (skip the frontend build if already built)
+
+set -euo pipefail
+
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$HERE/.." && pwd)"
+BACKEND="$ROOT"
+FRONTEND="$(cd "$ROOT/.." && pwd)/dispatch-web"
+
+BUILD_FRONTEND=1
+if [[ "${1:-}" == "--no-frontend" ]]; then
+	BUILD_FRONTEND=0
+fi
+
+echo "[build] backend binary → dist/dispatch-server"
+mkdir -p "$ROOT/dist"
+bun build --compile "$BACKEND/packages/host-bin/src/main.ts" \
+	--outfile "$ROOT/dist/dispatch-server" \
+	--minify 2>&1 | tail -3
+
+echo "[build] CLI binary → dist/dispatch"
+bun build --compile "$BACKEND/packages/cli/src/main.ts" \
+	--outfile "$ROOT/dist/dispatch" \
+	--minify 2>&1 | tail -3
+
+if [[ "$BUILD_FRONTEND" -eq 1 ]]; then
+	if [[ ! -d "$FRONTEND" ]]; then
+		echo "[build] frontend not found at $FRONTEND — skipping" >&2
+	else
+		echo "[build] frontend → dist/web/ (VITE_HTTP_PORT=24991 VITE_WS_PORT=24990)"
+		(
+			cd "$FRONTEND"
+			VITE_HTTP_PORT=24991 VITE_WS_PORT=24990 bun run build 2>&1 | tail -5
+		)
+		rm -rf "$ROOT/dist/web"
+		cp -r "$FRONTEND/dist" "$ROOT/dist/web"
+		echo "[build] copied $(find "$ROOT/dist/web" -type f | wc -l) files"
+	fi
+fi
+
+echo "[build] done."
+echo "  dist/dispatch-server   ($(du -h "$ROOT/dist/dispatch-server" | cut -f1))"
+echo "  dist/dispatch          ($(du -h "$ROOT/dist/dispatch" | cut -f1))"
+[[ -d "$ROOT/dist/web" ]] && echo "  dist/web/              ($(du -sh "$ROOT/dist/web" | cut -f1))"
diff --git a/bin/install b/bin/install
new file mode 100755
index 0000000..57d0684
--- /dev/null
+++ b/bin/install
@@ -0,0 +1,119 @@
+#!/usr/bin/env bash
+# bin/install — build + install Dispatch as a systemd service on Arch Linux.
+#
+# Usage:
+#   sudo bin/install              # build + install + enable + start
+#   sudo bin/install --no-build   # install only (skip the build step)
+#   sudo bin/install --uninstall  # stop + disable + remove files
+#
+# What it installs:
+#   /usr/bin/dispatch-server      — backend binary
+#   /usr/bin/dispatch             — CLI binary
+#   /usr/share/dispatch/web/      — frontend static files
+#   /etc/dispatch/env             — server config (EnvironmentFile)
+#   /etc/systemd/system/dispatch.service — systemd unit
+#   /var/lib/dispatch/            — data directory (SQLite DBs)
+#   /var/log/dispatch/            — journal + trace logs
+#
+# After install:  systemctl status dispatch
+# Logs:           journalctl -u dispatch -f
+# Config:         edit /etc/dispatch/env then `systemctl restart dispatch`
+
+set -euo pipefail
+
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$HERE/.." && pwd)"
+
+if [[ "$(id -u)" -ne 0 ]]; then
+	echo "install: must run as root (use sudo)" >&2
+	exit 1
+fi
+
+ACTION="install"
+NO_BUILD=0
+for arg in "$@"; do
+	case "$arg" in
+		--no-build) NO_BUILD=1 ;;
+		--uninstall) ACTION="uninstall" ;;
+		*) echo "install: unknown flag: $arg" >&2; exit 1 ;;
+	esac
+done
+
+# ─── Uninstall ───────────────────────────────────────────────────────────────
+if [[ "$ACTION" == "uninstall" ]]; then
+	echo "[uninstall] stopping service…"
+	systemctl stop dispatch 2>/dev/null || true
+	systemctl disable dispatch 2>/dev/null || true
+	rm -f /etc/systemd/system/dispatch.service
+	systemctl daemon-reload
+	echo "[uninstall] removing files…"
+	rm -f /usr/bin/dispatch-server /usr/bin/dispatch
+	rm -rf /usr/share/dispatch/web
+	# Keep config + data (user might want them)
+	echo "[uninstall] done."
+	echo "  Kept: /etc/dispatch/env, /var/lib/dispatch/, /var/log/dispatch/"
+	echo "  Remove manually if desired: rm -rf /etc/dispatch /var/lib/dispatch /var/log/dispatch"
+	exit 0
+fi
+
+# ─── Build ───────────────────────────────────────────────────────────────────
+if [[ "$NO_BUILD" -eq 0 ]]; then
+	echo "[install] building…"
+	"$ROOT/bin/build"
+fi
+
+# Verify outputs exist
+if [[ ! -f "$ROOT/dist/dispatch-server" ]]; then
+	echo "install: dist/dispatch-server not found — run bin/build first" >&2
+	exit 1
+fi
+
+# ─── Install binaries ────────────────────────────────────────────────────────
+echo "[install] binaries → /usr/bin/"
+install -Dm755 "$ROOT/dist/dispatch-server" /usr/bin/dispatch-server
+install -Dm755 "$ROOT/dist/dispatch" /usr/bin/dispatch
+
+# ─── Install frontend ────────────────────────────────────────────────────────
+if [[ -d "$ROOT/dist/web" ]]; then
+	echo "[install] frontend → /usr/share/dispatch/web/"
+	mkdir -p /usr/share/dispatch/web
+	cp -r "$ROOT/dist/web/"* /usr/share/dispatch/web/
+fi
+
+# ─── Install systemd service ─────────────────────────────────────────────────
+echo "[install] systemd service → /etc/systemd/system/"
+install -Dm644 "$ROOT/systemd/dispatch.service" /etc/systemd/system/dispatch.service
+
+# ─── Config (don't overwrite if it exists) ───────────────────────────────────
+if [[ ! -f /etc/dispatch/env ]]; then
+	echo "[install] config → /etc/dispatch/env (edit with your API key)"
+	install -Dm600 "$ROOT/systemd/dispatch.env" /etc/dispatch/env
+	echo "  ⚠️  Edit /etc/dispatch/env and set DISPATCH_API_KEY before starting!"
+else
+	echo "[install] config /etc/dispatch/env already exists — keeping"
+fi
+
+# ─── Data + log directories ──────────────────────────────────────────────────
+mkdir -p /var/lib/dispatch /var/log/dispatch
+
+# ─── Enable + start ──────────────────────────────────────────────────────────
+systemctl daemon-reload
+systemctl enable dispatch
+
+if grep -q 'sk-\.\.\.' /etc/dispatch/env 2>/dev/null; then
+	echo ""
+	echo "[install] done — but DISPATCH_API_KEY is still the placeholder."
+	echo "  1. Edit /etc/dispatch/env and set your API key"
+	echo "  2. systemctl start dispatch"
+	echo "  3. journalctl -u dispatch -f"
+else
+	echo "[install] starting service…"
+	systemctl start dispatch
+	echo ""
+	echo "[install] done!"
+	echo "  Status:  systemctl status dispatch"
+	echo "  Logs:    journalctl -u dispatch -f"
+	echo "  Config:  /etc/dispatch/env"
+	echo "  Frontend: http://localhost:24991"
+	echo "  API:      http://localhost:24991/chat"
+fi