Fix: rename workbench and prepare for release (#27)

* chore: rename workbench to FreecadRobustMCPBridge * fix: stdio cleanup and bug fix for JSON RPC * fix: update FreeCAD MCP bridge and tests * test: Fix GUI Integration tests and other issues * fix: unit tests in CI and a few other things * docs: generate GitHub pages site and link to it. * fix: General code improvements and DRY refactoring * chore: General cleanup * chore: small fixes * docs: cleanup * docs: fixes * docs: small corrections * docs: fix * test: release check * bump: workbench v0.6.0 * chore: bump macros to 0.6.0 * docs: Release improvements * refactor: improve DRYness of code
2026-01-12 09:30:05 -08:00
parent 8c338f6da7
commit f14ab8177d
92 changed files with 2740 additions and 727 deletions
@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+# Shared helper functions for FreeCAD MCP Bridge management
+# Source this file in Just recipes: . ./scripts/bridge-helpers.sh
+
+# Helper function to kill process on a port (with fallback for systems without lsof)
+# Usage: kill_port PORT [SIGNAL]
+# Examples: kill_port 9875      (sends SIGTERM)
+#           kill_port 9875 -9   (sends SIGKILL)
+kill_port() {
+    local port=$1
+    local signal=${2:--TERM}  # Default to SIGTERM if no signal specified
+    local pids=""
+
+    if command -v lsof &>/dev/null; then
+        # Collect PIDs first, then kill only if non-empty
+        pids=$(lsof -ti:"$port" 2>/dev/null || true)
+        if [[ -n "$pids" ]]; then
+            echo "$pids" | xargs kill "$signal" 2>/dev/null || true
+        fi
+    elif command -v fuser &>/dev/null; then
+        # fuser -k sends SIGKILL by default; use --signal for others
+        # Check if port is in use first
+        if fuser "$port/tcp" 2>/dev/null; then
+            if [ "$signal" = "-9" ] || [ "$signal" = "-KILL" ]; then
+                fuser -k "$port/tcp" 2>/dev/null || true
+            else
+                fuser -k --signal "${signal#-}" "$port/tcp" 2>/dev/null || true
+            fi
+        fi
+    else
+        echo "Warning: Neither lsof nor fuser available, cannot kill port $port"
+    fi
+}
+
+# Check if the MCP bridge is running and responsive
+# Returns 0 (true) if bridge is running, 1 (false) otherwise
+is_bridge_running() {
+    local port=${1:-9875}  # Default to port 9875
+    curl -s --connect-timeout 1 --max-time 1 "http://localhost:$port" > /dev/null 2>&1 && \
+    uv run python -c "import socket; socket.setdefaulttimeout(2); import xmlrpc.client; print(xmlrpc.client.ServerProxy('http://localhost:$port').ping())" 2>/dev/null | grep -q "pong"
+}
+
+# Force kill any processes on the default MCP bridge ports
+# Usage: force_kill_bridge_ports
+force_kill_bridge_ports() {
+    kill_port 9875 -9
+    kill_port 9876 -9
+}
+
+# Graceful shutdown of bridge ports (SIGTERM first, then SIGKILL)
+# Usage: graceful_kill_bridge_ports
+graceful_kill_bridge_ports() {
+    kill_port 9875
+    kill_port 9876
+    sleep 1
+    kill_port 9875 -9
+    kill_port 9876 -9
+}