chore(phrocs): Auto-update phrocs binary on pnpm install (#3458)

Author: charlesvien

README.md

@@ -34,7 +34,7 @@ cp .env.example .env
 
 ### Running in Development
 
-By default, `pnpm dev` uses phrocs (our custom process runner) to run the agent and code app in parallel. phrocs auto-installs on first run and reads the `mprocs.yaml` config file. The binary is downloaded to `bin/phrocs` and is git-ignored.
+By default, `pnpm dev` uses phrocs (our custom process runner) to run the agent and code app in parallel. phrocs auto-installs and keeps itself up to date: on every `pnpm install` the local binary is checked against the latest `phrocs-latest` release checksums and re-downloaded if it differs (skipped when offline or in CI). `pnpm dev` only downloads it if it is missing entirely. It reads the `mprocs.yaml` config file. The binary lives at `bin/phrocs` and is git-ignored.
 
 ```bash
 # Run both agent (watch mode) and code app in parallel
@@ -44,8 +44,6 @@ pnpm dev
 pnpm dev:agent  # Run agent in watch mode
 pnpm dev:code   # Run code app
 
-# Manually update phrocs to the latest version
-pnpm update:phrocs
 
 # Use mprocs instead of phrocs
 pnpm dev:mprocs

package.json

@@ -9,6 +9,7 @@
   "packageManager": "pnpm@10.23.0+sha512.21c4e5698002ade97e4efe8b8b4a89a8de3c85a37919f957e7a0f30f38fbc5bbdd05980ffe29179b2fb6e6e691242e098d945d1601772cad0fef5fb6411e2a4b",
   "scripts": {
     "preinstall": "node scripts/enforce-pnpm.mjs",
+    "postinstall": "bash scripts/ensure-phrocs.sh --update",
     "setup": "bash apps/code/bin/setup",
     "prepare": "husky",
     "dev": "pnpm build:deps && bash scripts/ensure-phrocs.sh && bin/phrocs --config mprocs.yaml",
@@ -34,8 +35,7 @@
     "format": "biome format --write",
     "clean": "pnpm -r clean",
     "knip": "knip",
-    "skills:pull": "node scripts/pull-skills.mjs",
-    "update:phrocs": "rm -f bin/phrocs && bash scripts/ensure-phrocs.sh"
+    "skills:pull": "node scripts/pull-skills.mjs"
   },
   "keywords": [
     "posthog",

scripts/ensure-phrocs.sh

@@ -2,12 +2,18 @@
 set -euo pipefail
 
 PHROCS_BIN="bin/phrocs"
+RELEASE_URL="https://github.com/PostHog/posthog/releases/download/phrocs-latest"
 
-if [ -x "$PHROCS_BIN" ]; then
+MODE="ensure"
+[ "${1:-}" = "--update" ] && MODE="update"
+
+if [ "$MODE" = "update" ] && [ -n "${CI:-}" ]; then
   exit 0
 fi
 
-echo "phrocs not found, downloading..."
+if [ "$MODE" = "ensure" ] && [ -x "$PHROCS_BIN" ]; then
+  exit 0
+fi
 
 ARCH=$(uname -m)
 OS=$(uname -s | tr '[:upper:]' '[:lower:]')
@@ -24,10 +30,51 @@ case "$OS" in
 esac
 
 BINARY="phrocs-${OS}-${ARCH}"
-URL="https://github.com/PostHog/posthog/releases/download/phrocs-latest/${BINARY}"
 
-mkdir -p bin
-curl -fSL "$URL" -o "$PHROCS_BIN"
-chmod +x "$PHROCS_BIN"
+sha256() {
+  if command -v sha256sum >/dev/null 2>&1; then
+    sha256sum "$1" | awk '{print $1}'
+  else
+    shasum -a 256 "$1" | awk '{print $1}'
+  fi
+}
+
+bail() {
+  if [ -x "$PHROCS_BIN" ]; then
+    echo "phrocs: $1, keeping existing binary" >&2
+    exit 0
+  fi
+  echo "phrocs: $1 and no local binary exists" >&2
+  if [ "$MODE" = "update" ]; then
+    echo "phrocs: will retry on next pnpm install or pnpm dev" >&2
+    exit 0
+  fi
+  exit 1
+}
+
+TMP_DIR=$(mktemp -d)
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+curl -fsSL --max-time 10 "${RELEASE_URL}/checksums.txt" -o "$TMP_DIR/checksums.txt" \
+  || bail "could not fetch checksums"
+
+EXPECTED=$(awk -v bin="$BINARY" '{name = $2; sub(/^\*/, "", name); if (name == bin) {print $1; exit}}' "$TMP_DIR/checksums.txt")
+[ -n "$EXPECTED" ] || bail "no checksum for ${BINARY} in latest release"
 
-echo "phrocs installed to $PHROCS_BIN"
+if [ -x "$PHROCS_BIN" ] && [ "$(sha256 "$PHROCS_BIN")" = "$EXPECTED" ]; then
+  exit 0
+fi
+
+echo "phrocs: downloading latest release..."
+curl -fsSL --max-time 120 "${RELEASE_URL}/${BINARY}" -o "$TMP_DIR/phrocs" \
+  || bail "download failed"
+
+ACTUAL=$(sha256 "$TMP_DIR/phrocs")
+if [ "$ACTUAL" != "$EXPECTED" ]; then
+  bail "checksum mismatch on download (expected ${EXPECTED}, got ${ACTUAL})"
+fi
+
+mkdir -p bin
+chmod +x "$TMP_DIR/phrocs"
+mv "$TMP_DIR/phrocs" "$PHROCS_BIN"
+echo "phrocs: updated to latest (${PHROCS_BIN})"