chore: add bin/setup to setup package linking (#149)

Author: joshsny

.env.example

@@ -16,3 +16,6 @@ APPLE_TEAM_ID=
 APPLE_CODESIGN_CERT_BASE64=
 APPLE_CODESIGN_CERT_PASSWORD=
 APPLE_CODESIGN_KEYCHAIN_PASSWORD=
+
+# Uncomment to use local @posthog/agent package
+# AGENT_PACKAGE_LOCATION=file:../agent

.github/workflows/release.yml

@@ -93,6 +93,8 @@ jobs:
         with:
           node-version: 22
           cache: "pnpm"
+      - name: Setup workspace
+        run: bin/setup
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
       - name: Import code signing certificate

.github/workflows/typecheck.yml

@@ -19,6 +19,8 @@ jobs:
         uses: actions/setup-node@v4
         with:
           cache: 'pnpm'
+      - name: Setup workspace
+        run: bin/setup
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
       - name: Run type check

.husky/pre-commit

@@ -1 +1,20 @@
+#!/bin/bash
+
+# Load .env file if it exists
+if [ -f .env ]; then
+  export $(grep -v '^#' .env | grep -v '^[[:space:]]*$' | xargs 2>/dev/null)
+fi
+
+# Check if AGENT_PACKAGE_LOCATION is set and lockfile is being committed
+if [ -n "$AGENT_PACKAGE_LOCATION" ]; then
+  if git diff --cached --name-only | grep -q "pnpm-lock.yaml"; then
+    echo "❌ Error: Cannot commit pnpm-lock.yaml when AGENT_PACKAGE_LOCATION is set"
+    echo "   You have a local agent override active in .env"
+    echo "   Either:"
+    echo "   - Comment out AGENT_PACKAGE_LOCATION in .env and run bin/setup"
+    echo "   - Unstage pnpm-lock.yaml: git reset pnpm-lock.yaml"
+    exit 1
+  fi
+fi
+
 pnpm lint-staged

bin/setup

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+# Setup script for Array development environment
+# Run this after cloning or when changing AGENT_PACKAGE_LOCATION in .env
+
+echo "🔧 Setting up Array development environment..."
+
+# Load .env file if it exists
+if [ -f .env ]; then
+  export $(grep -v '^#' .env | grep -v '^[[:space:]]*$' | xargs)
+fi
+
+# Start with base workspace config
+cp pnpm-workspace.base.yaml pnpm-workspace.yaml
+
+# If AGENT_PACKAGE_LOCATION is set, add the override and build the agent
+if [ -n "$AGENT_PACKAGE_LOCATION" ]; then
+  echo "✓ Using local @posthog/agent from: $AGENT_PACKAGE_LOCATION"
+  cat >> pnpm-workspace.yaml <<EOF
+
+overrides:
+  "@posthog/agent": $AGENT_PACKAGE_LOCATION
+EOF
+
+  # Extract the path from file:../agent format
+  AGENT_PATH="${AGENT_PACKAGE_LOCATION#file:}"
+
+  if [ -d "$AGENT_PATH" ]; then
+    echo "📦 Building @posthog/agent..."
+    (cd "$AGENT_PATH" && pnpm install && pnpm build)
+    echo "✓ @posthog/agent built successfully"
+  else
+    echo "⚠️  Warning: Agent path $AGENT_PATH does not exist"
+  fi
+else
+  echo "✓ Using production @posthog/agent package"
+fi
+
+echo "✓ Workspace configured"

package.json

@@ -10,6 +10,7 @@
   },
   "packageManager": "[email protected]",
   "scripts": {
+    "setup": "bash bin/setup",
     "start": "electron-forge start",
     "package": "electron-forge package",
     "make": "electron-forge make",

pnpm-workspace.yaml renamed to pnpm-workspace.base.yaml

@@ -3,4 +3,4 @@ packages:
 
 onlyBuiltDependencies:
   - electron
-  - esbuild
+  - esbuild