@a5c-ai/babysitter-cursor 5.0.1-staging.5cd43600 → 5.0.1-staging.6e094dee

package/hooks/babysitter-proxied-session-start.ps1

@@ -0,0 +1,196 @@
+# Unified Session Start Hook for Cursor IDE/CLI (PowerShell)
+# Routes through hooks-proxy for all hook execution.
+#
+# Ensures the babysitter SDK CLI and hooks-proxy are installed (from versions.json
+# sdkVersion), then delegates to the SDK hook handler via hooks-proxy.
+#
+# Protocol:
+#   Input:  JSON via stdin (contains session_id, cwd, etc.)
+#   Output: JSON via stdout ({} on success)
+#   Stderr: debug/log output only
+#   Exit 0: success
+#   Exit 2: block (fatal error)
+
+$ErrorActionPreference = "Stop"
+
+$PluginRoot = if ($env:CURSOR_PLUGIN_ROOT) { $env:CURSOR_PLUGIN_ROOT } else { Split-Path -Parent $PSScriptRoot }
+$GlobalRoot = if ($env:BABYSITTER_GLOBAL_STATE_DIR) { $env:BABYSITTER_GLOBAL_STATE_DIR } else { Join-Path $HOME ".a5c" }
+$StateDir = if ($env:BABYSITTER_STATE_DIR) { $env:BABYSITTER_STATE_DIR } else { Join-Path $GlobalRoot "state" }
+$SdkMarkerFile = Join-Path $PluginRoot ".babysitter-install-attempted"
+$ProxyMarkerFile = Join-Path $PluginRoot ".hooks-proxy-install-attempted"
+
+$env:CURSOR_PLUGIN_ROOT = $PluginRoot
+$env:BABYSITTER_STATE_DIR = $StateDir
+
+$LogDir = if ($env:BABYSITTER_LOG_DIR) { $env:BABYSITTER_LOG_DIR } else { Join-Path $GlobalRoot "logs" }
+$LogFile = Join-Path $LogDir "babysitter-session-start-hook.log"
+New-Item -ItemType Directory -Path $LogDir -Force -ErrorAction SilentlyContinue | Out-Null
+
+function Write-Blog {
+    param([string]$Message)
+    $ts = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
+    Add-Content -Path $LogFile -Value "[INFO] $ts $Message" -ErrorAction SilentlyContinue
+    if (Get-Command babysitter -ErrorAction SilentlyContinue) {
+        & babysitter log --type hook --label "hook:session-start" --message $Message --source shell-hook 2>$null
+    }
+}
+
+Write-Blog "Unified hook script invoked"
+Write-Blog "PLUGIN_ROOT=$PluginRoot"
+Write-Blog "STATE_DIR=$StateDir"
+
+# Get required SDK version from versions.json (used for both SDK and hooks-proxy)
+$versionsFile = Join-Path $PluginRoot "versions.json"
+try {
+    $SdkVersion = (Get-Content $versionsFile -Raw | ConvertFrom-Json).sdkVersion
+    if (-not $SdkVersion) { $SdkVersion = "latest" }
+} catch {
+    $SdkVersion = "latest"
+}
+
+# ---------------------------------------------------------------------------
+# SDK install/upgrade
+# ---------------------------------------------------------------------------
+
+function Install-Sdk {
+    param([string]$TargetVersion)
+    try {
+        & npm i -g "@a5c-ai/babysitter-sdk@$TargetVersion" --loglevel=error 2>$null
+        if ($LASTEXITCODE -eq 0) {
+            Write-Blog "Installed SDK globally ($TargetVersion)"
+            return $true
+        }
+    } catch {}
+    try {
+        $prefix = Join-Path $env:USERPROFILE ".local"
+        & npm i -g "@a5c-ai/babysitter-sdk@$TargetVersion" --prefix $prefix --loglevel=error 2>$null
+        if ($LASTEXITCODE -eq 0) {
+            $env:PATH = "$prefix\bin;$env:PATH"
+            Write-Blog "Installed SDK to user prefix ($TargetVersion)"
+            return $true
+        }
+    } catch {}
+    return $false
+}
+
+$NeedsSdkInstall = $false
+if (Get-Command babysitter -ErrorAction SilentlyContinue) {
+    $CurrentVersion = & babysitter --version 2>$null
+    if ($CurrentVersion -ne $SdkVersion) {
+        Write-Blog "SDK version mismatch: installed=$CurrentVersion, required=$SdkVersion"
+        $NeedsSdkInstall = $true
+    } else {
+        Write-Blog "SDK version OK: $CurrentVersion"
+    }
+} else {
+    Write-Blog "SDK CLI not found, will install"
+    $NeedsSdkInstall = $true
+}
+
+if ($NeedsSdkInstall -and -not (Test-Path $SdkMarkerFile)) {
+    Install-Sdk $SdkVersion | Out-Null
+    Set-Content -Path $SdkMarkerFile -Value $SdkVersion -ErrorAction SilentlyContinue
+}
+
+$useSdkFallback = $false
+if (-not (Get-Command babysitter -ErrorAction SilentlyContinue)) {
+    Write-Blog "CLI not found after install, using npx fallback"
+    $useSdkFallback = $true
+}
+
+# ---------------------------------------------------------------------------
+# Hooks-proxy install/upgrade (same pattern as SDK)
+# ---------------------------------------------------------------------------
+
+function Install-HooksProxy {
+    param([string]$TargetVersion)
+    try {
+        & npm i -g "@a5c-ai/hooks-proxy-cli@$TargetVersion" --loglevel=error 2>$null
+        if ($LASTEXITCODE -eq 0) {
+            Write-Blog "Installed hooks-proxy globally ($TargetVersion)"
+            return $true
+        }
+    } catch {}
+    try {
+        $prefix = Join-Path $env:USERPROFILE ".local"
+        & npm i -g "@a5c-ai/hooks-proxy-cli@$TargetVersion" --prefix $prefix --loglevel=error 2>$null
+        if ($LASTEXITCODE -eq 0) {
+            $env:PATH = "$prefix\bin;$env:PATH"
+            Write-Blog "Installed hooks-proxy to user prefix ($TargetVersion)"
+            return $true
+        }
+    } catch {}
+    return $false
+}
+
+$NeedsProxyInstall = $false
+$Proxy = $null
+if (Get-Command a5c-hooks-proxy -ErrorAction SilentlyContinue) {
+    $ProxyVersion = & a5c-hooks-proxy --version 2>$null
+    if ($ProxyVersion -ne $SdkVersion) {
+        Write-Blog "hooks-proxy version mismatch: installed=$ProxyVersion, required=$SdkVersion"
+        $NeedsProxyInstall = $true
+    } else {
+        Write-Blog "hooks-proxy version OK: $ProxyVersion"
+        $Proxy = "a5c-hooks-proxy"
+    }
+} else {
+    $localProxy = Join-Path $env:USERPROFILE ".local\bin\a5c-hooks-proxy.exe"
+    if (Test-Path $localProxy) {
+        $ProxyVersion = & $localProxy --version 2>$null
+        if ($ProxyVersion -ne $SdkVersion) {
+            Write-Blog "hooks-proxy version mismatch: installed=$ProxyVersion, required=$SdkVersion"
+            $NeedsProxyInstall = $true
+        } else {
+            Write-Blog "hooks-proxy version OK: $ProxyVersion"
+            $Proxy = $localProxy
+        }
+    } else {
+        Write-Blog "hooks-proxy not found, will install"
+        $NeedsProxyInstall = $true
+    }
+}
+
+if ($NeedsProxyInstall -and -not (Test-Path $ProxyMarkerFile)) {
+    Install-HooksProxy $SdkVersion | Out-Null
+    Set-Content -Path $ProxyMarkerFile -Value $SdkVersion -ErrorAction SilentlyContinue
+}
+
+# Re-resolve after potential install
+if (-not $Proxy) {
+    if (Get-Command a5c-hooks-proxy -ErrorAction SilentlyContinue) {
+        $Proxy = "a5c-hooks-proxy"
+    } else {
+        $localProxy = Join-Path $env:USERPROFILE ".local\bin\a5c-hooks-proxy.exe"
+        if (Test-Path $localProxy) {
+            $Proxy = $localProxy
+        }
+    }
+}
+
+# ---------------------------------------------------------------------------
+# Capture stdin and delegate to hooks-proxy
+# ---------------------------------------------------------------------------
+
+$InputFile = [System.IO.Path]::GetTempFileName()
+$input | Out-File -FilePath $InputFile -Encoding utf8
+
+Write-Blog "Hook input received"
+
+$stderrLog = Join-Path $LogDir "babysitter-session-start-hook-stderr.log"
+
+if ($Proxy) {
+    Write-Blog "Using hooks-proxy: $Proxy"
+    $Result = Get-Content $InputFile | & $Proxy invoke --adapter cursor --handler "babysitter hook:run --harness unified --hook-type session-start --plugin-root $PluginRoot --state-dir $StateDir --json" --json 2>$stderrLog
+    $ExitCode = $LASTEXITCODE
+} else {
+    Write-Blog "hooks-proxy not found after install, using npx fallback"
+    $Result = Get-Content $InputFile | & npx -y "@a5c-ai/hooks-proxy-cli@$SdkVersion" invoke --adapter cursor --handler "babysitter hook:run --harness unified --hook-type session-start --plugin-root $PluginRoot --state-dir $StateDir --json" --json 2>$stderrLog
+    $ExitCode = $LASTEXITCODE
+}
+
+Write-Blog "CLI exit code=$ExitCode"
+
+Remove-Item $InputFile -Force -ErrorAction SilentlyContinue
+Write-Output $Result
+exit $ExitCode

package/hooks/babysitter-proxied-session-start.sh

@@ -0,0 +1,174 @@
+#!/usr/bin/env bash
+# Unified Session Start Hook - routes through hooks-proxy for all hook execution.
+#
+# Ensures the babysitter SDK CLI and hooks-proxy are installed (from versions.json
+# sdkVersion), then delegates to the SDK hook handler via hooks-proxy.
+#
+# Protocol:
+#   Input:  JSON via stdin (contains session_id, cwd, etc.)
+#   Output: JSON via stdout ({} on success)
+#   Stderr: debug/log output only
+#   Exit 0: success
+#   Exit 2: block (fatal error)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+GLOBAL_ROOT="${BABYSITTER_GLOBAL_STATE_DIR:-$HOME/.a5c}"
+STATE_DIR="${BABYSITTER_STATE_DIR:-${GLOBAL_ROOT}/state}"
+LOG_DIR="${BABYSITTER_LOG_DIR:-${GLOBAL_ROOT}/logs}"
+LOG_FILE="$LOG_DIR/babysitter-session-start-hook.log"
+SDK_MARKER_FILE="${PLUGIN_ROOT}/.babysitter-install-attempted"
+PROXY_MARKER_FILE="${PLUGIN_ROOT}/.hooks-proxy-install-attempted"
+
+export CURSOR_PLUGIN_ROOT="${CURSOR_PLUGIN_ROOT:-${PLUGIN_ROOT}}"
+export BABYSITTER_STATE_DIR="${STATE_DIR}"
+
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+blog() {
+  local msg="$1"
+  local ts
+  ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  echo "[INFO] $ts $msg" >> "$LOG_FILE" 2>/dev/null
+  if command -v babysitter &>/dev/null; then
+    babysitter log --type hook --label "hook:session-start" --message "$msg" --source shell-hook 2>/dev/null || true
+  fi
+}
+
+blog "Unified hook script invoked"
+blog "PLUGIN_ROOT=$PLUGIN_ROOT"
+blog "STATE_DIR=$STATE_DIR"
+
+# Get required SDK version from versions.json (used for both SDK and hooks-proxy)
+SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${PLUGIN_ROOT}/versions.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}" 2>/dev/null || echo "latest")
+
+# ---------------------------------------------------------------------------
+# SDK install/upgrade
+# ---------------------------------------------------------------------------
+
+install_sdk() {
+  local target_version="$1"
+  if npm i -g "@a5c-ai/babysitter-sdk@${target_version}" --loglevel=error 2>/dev/null; then
+    blog "Installed SDK globally (${target_version})"
+    return 0
+  else
+    if npm i -g "@a5c-ai/babysitter-sdk@${target_version}" --prefix "$HOME/.local" --loglevel=error 2>/dev/null; then
+      export PATH="$HOME/.local/bin:$PATH"
+      blog "Installed SDK to user prefix (${target_version})"
+      return 0
+    fi
+  fi
+  return 1
+}
+
+NEEDS_SDK_INSTALL=false
+if command -v babysitter &>/dev/null; then
+  CURRENT_VERSION=$(babysitter --version 2>/dev/null || echo "unknown")
+  if [ "$CURRENT_VERSION" != "$SDK_VERSION" ]; then
+    blog "SDK version mismatch: installed=${CURRENT_VERSION}, required=${SDK_VERSION}"
+    NEEDS_SDK_INSTALL=true
+  else
+    blog "SDK version OK: ${CURRENT_VERSION}"
+  fi
+else
+  blog "SDK CLI not found, will install"
+  NEEDS_SDK_INSTALL=true
+fi
+
+if [ "$NEEDS_SDK_INSTALL" = true ] && [ ! -f "$SDK_MARKER_FILE" ]; then
+  install_sdk "$SDK_VERSION"
+  echo "$SDK_VERSION" > "$SDK_MARKER_FILE" 2>/dev/null
+fi
+
+if ! command -v babysitter &>/dev/null; then
+  blog "CLI not found after install, using npx fallback"
+  babysitter() { npx -y "@a5c-ai/babysitter-sdk@${SDK_VERSION}" "$@"; }
+  export -f babysitter
+fi
+
+# ---------------------------------------------------------------------------
+# Hooks-proxy install/upgrade (same pattern as SDK)
+# ---------------------------------------------------------------------------
+
+install_hooks_proxy() {
+  local target_version="$1"
+  if npm i -g "@a5c-ai/hooks-proxy-cli@${target_version}" --loglevel=error 2>/dev/null; then
+    blog "Installed hooks-proxy globally (${target_version})"
+    return 0
+  else
+    if npm i -g "@a5c-ai/hooks-proxy-cli@${target_version}" --prefix "$HOME/.local" --loglevel=error 2>/dev/null; then
+      export PATH="$HOME/.local/bin:$PATH"
+      blog "Installed hooks-proxy to user prefix (${target_version})"
+      return 0
+    fi
+  fi
+  return 1
+}
+
+NEEDS_PROXY_INSTALL=false
+if command -v a5c-hooks-proxy &>/dev/null; then
+  PROXY_VERSION=$(a5c-hooks-proxy --version 2>/dev/null || echo "unknown")
+  if [ "$PROXY_VERSION" != "$SDK_VERSION" ]; then
+    blog "hooks-proxy version mismatch: installed=${PROXY_VERSION}, required=${SDK_VERSION}"
+    NEEDS_PROXY_INSTALL=true
+  else
+    blog "hooks-proxy version OK: ${PROXY_VERSION}"
+  fi
+elif [ -f "$HOME/.local/bin/a5c-hooks-proxy" ]; then
+  export PATH="$HOME/.local/bin:$PATH"
+  PROXY_VERSION=$(a5c-hooks-proxy --version 2>/dev/null || echo "unknown")
+  if [ "$PROXY_VERSION" != "$SDK_VERSION" ]; then
+    blog "hooks-proxy version mismatch: installed=${PROXY_VERSION}, required=${SDK_VERSION}"
+    NEEDS_PROXY_INSTALL=true
+  else
+    blog "hooks-proxy version OK: ${PROXY_VERSION}"
+  fi
+else
+  blog "hooks-proxy not found, will install"
+  NEEDS_PROXY_INSTALL=true
+fi
+
+if [ "$NEEDS_PROXY_INSTALL" = true ] && [ ! -f "$PROXY_MARKER_FILE" ]; then
+  install_hooks_proxy "$SDK_VERSION"
+  echo "$SDK_VERSION" > "$PROXY_MARKER_FILE" 2>/dev/null
+fi
+
+# Resolve hooks-proxy binary (npx fallback if still not found)
+PROXY=""
+if command -v a5c-hooks-proxy &>/dev/null; then
+  PROXY="a5c-hooks-proxy"
+elif [ -f "$HOME/.local/bin/a5c-hooks-proxy" ]; then
+  PROXY="$HOME/.local/bin/a5c-hooks-proxy"
+fi
+
+if [ -z "$PROXY" ]; then
+  blog "hooks-proxy not found after install, using npx fallback"
+  PROXY="npx -y @a5c-ai/hooks-proxy-cli@${SDK_VERSION} "
+fi
+
+# ---------------------------------------------------------------------------
+# Capture stdin and delegate to hooks-proxy
+# ---------------------------------------------------------------------------
+
+INPUT_FILE=$(mktemp 2>/dev/null || echo "/tmp/cursor-session-start-hook-$$.json")
+cat > "$INPUT_FILE"
+
+blog "Hook input received ($(wc -c < "$INPUT_FILE") bytes)"
+
+STDERR_LOG="$LOG_DIR/babysitter-session-start-hook-stderr.log"
+
+blog "Using hooks-proxy: $PROXY"
+RESULT=$($PROXY invoke \
+  --adapter cursor \
+  --handler "babysitter hook:run --harness unified --hook-type session-start --plugin-root ${CURSOR_PLUGIN_ROOT} --state-dir ${BABYSITTER_STATE_DIR} --json" \
+  --json \
+  < "$INPUT_FILE" 2>"$STDERR_LOG")
+EXIT_CODE=$?
+
+blog "CLI exit code=$EXIT_CODE"
+
+rm -f "$INPUT_FILE" 2>/dev/null
+printf '%s\n' "$RESULT"
+exit $EXIT_CODE

package/hooks/babysitter-proxied-stop-hook.ps1

@@ -0,0 +1,125 @@
+# Unified Stop Hook for Cursor IDE/CLI (PowerShell)
+# Routes through hooks-proxy for all hook execution.
+#
+# Drives the orchestration loop by checking run state on session stop.
+#
+# Protocol:
+#   Input:  JSON via stdin (session context)
+#   Output: JSON via stdout (with optional continue/stop signal)
+#   Stderr: debug/log output only
+#   Exit 0: success
+
+$ErrorActionPreference = "Stop"
+
+$PluginRoot = if ($env:CURSOR_PLUGIN_ROOT) { $env:CURSOR_PLUGIN_ROOT } else { Split-Path -Parent $PSScriptRoot }
+$GlobalRoot = if ($env:BABYSITTER_GLOBAL_STATE_DIR) { $env:BABYSITTER_GLOBAL_STATE_DIR } else { Join-Path $HOME ".a5c" }
+$StateDir = if ($env:BABYSITTER_STATE_DIR) { $env:BABYSITTER_STATE_DIR } else { Join-Path $GlobalRoot "state" }
+$ProxyMarkerFile = Join-Path $PluginRoot ".hooks-proxy-install-attempted"
+
+$env:CURSOR_PLUGIN_ROOT = $PluginRoot
+$env:BABYSITTER_STATE_DIR = $StateDir
+
+$LogDir = if ($env:BABYSITTER_LOG_DIR) { $env:BABYSITTER_LOG_DIR } else { Join-Path $GlobalRoot "logs" }
+$LogFile = Join-Path $LogDir "babysitter-stop-hook.log"
+New-Item -ItemType Directory -Path $LogDir -Force -ErrorAction SilentlyContinue | Out-Null
+
+function Write-Blog {
+    param([string]$Message)
+    $ts = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
+    Add-Content -Path $LogFile -Value "[INFO] $ts $Message" -ErrorAction SilentlyContinue
+    if (Get-Command babysitter -ErrorAction SilentlyContinue) {
+        & babysitter log --type hook --label "hook:stop" --message $Message --source shell-hook 2>$null
+    }
+}
+
+Write-Blog "Unified hook script invoked"
+Write-Blog "PLUGIN_ROOT=$PluginRoot"
+Write-Blog "STATE_DIR=$StateDir"
+
+# Get required version from versions.json (used for hooks-proxy)
+$versionsFile = Join-Path $PluginRoot "versions.json"
+try {
+    $SdkVersion = (Get-Content $versionsFile -Raw | ConvertFrom-Json).sdkVersion
+    if (-not $SdkVersion) { $SdkVersion = "latest" }
+} catch {
+    $SdkVersion = "latest"
+}
+
+# ---------------------------------------------------------------------------
+# Hooks-proxy install (same pattern as SDK install in session-start)
+# ---------------------------------------------------------------------------
+
+function Install-HooksProxy {
+    param([string]$TargetVersion)
+    try {
+        & npm i -g "@a5c-ai/hooks-proxy-cli@$TargetVersion" --loglevel=error 2>$null
+        if ($LASTEXITCODE -eq 0) {
+            Write-Blog "Installed hooks-proxy globally ($TargetVersion)"
+            return $true
+        }
+    } catch {}
+    try {
+        $prefix = Join-Path $env:USERPROFILE ".local"
+        & npm i -g "@a5c-ai/hooks-proxy-cli@$TargetVersion" --prefix $prefix --loglevel=error 2>$null
+        if ($LASTEXITCODE -eq 0) {
+            $env:PATH = "$prefix\bin;$env:PATH"
+            Write-Blog "Installed hooks-proxy to user prefix ($TargetVersion)"
+            return $true
+        }
+    } catch {}
+    return $false
+}
+
+# Resolve hooks-proxy binary
+$Proxy = $null
+if (Get-Command a5c-hooks-proxy -ErrorAction SilentlyContinue) {
+    $Proxy = "a5c-hooks-proxy"
+} else {
+    $localProxy = Join-Path $env:USERPROFILE ".local\bin\a5c-hooks-proxy.exe"
+    if (Test-Path $localProxy) {
+        $Proxy = $localProxy
+    }
+}
+
+# Install if not found (only attempt once per plugin version)
+if (-not $Proxy -and -not (Test-Path $ProxyMarkerFile)) {
+    Write-Blog "hooks-proxy not found, attempting install"
+    Install-HooksProxy $SdkVersion | Out-Null
+    Set-Content -Path $ProxyMarkerFile -Value $SdkVersion -ErrorAction SilentlyContinue
+    # Re-resolve after install
+    if (Get-Command a5c-hooks-proxy -ErrorAction SilentlyContinue) {
+        $Proxy = "a5c-hooks-proxy"
+    } else {
+        $localProxy = Join-Path $env:USERPROFILE ".local\bin\a5c-hooks-proxy.exe"
+        if (Test-Path $localProxy) {
+            $Proxy = $localProxy
+        }
+    }
+}
+
+# ---------------------------------------------------------------------------
+# Capture stdin and delegate to hooks-proxy
+# ---------------------------------------------------------------------------
+
+$InputFile = [System.IO.Path]::GetTempFileName()
+$input | Out-File -FilePath $InputFile -Encoding utf8
+
+Write-Blog "Hook input received"
+
+$stderrLog = Join-Path $LogDir "babysitter-stop-hook-stderr.log"
+
+if ($Proxy) {
+    Write-Blog "Using hooks-proxy: $Proxy"
+    $Result = Get-Content $InputFile | & $Proxy invoke --adapter cursor --handler "babysitter hook:run --harness unified --hook-type stop --plugin-root $PluginRoot --state-dir $StateDir --json" --json 2>$stderrLog
+    $ExitCode = $LASTEXITCODE
+} else {
+    Write-Blog "hooks-proxy not found after install, using npx fallback"
+    $Result = Get-Content $InputFile | & npx -y "@a5c-ai/hooks-proxy-cli@$SdkVersion" invoke --adapter cursor --handler "babysitter hook:run --harness unified --hook-type stop --plugin-root $PluginRoot --state-dir $StateDir --json" --json 2>$stderrLog
+    $ExitCode = $LASTEXITCODE
+}
+
+Write-Blog "CLI exit code=$ExitCode"
+
+Remove-Item $InputFile -Force -ErrorAction SilentlyContinue
+Write-Output $Result
+exit $ExitCode

package/hooks/babysitter-proxied-stop-hook.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# Unified Stop Hook - routes through hooks-proxy for all hook execution.
+#
+# Drives the orchestration loop by checking run state on session stop.
+#
+# Protocol:
+#   Input:  JSON via stdin (session context)
+#   Output: JSON via stdout (with optional continue/stop signal)
+#   Stderr: debug/log output only
+#   Exit 0: success
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+GLOBAL_ROOT="${BABYSITTER_GLOBAL_STATE_DIR:-$HOME/.a5c}"
+STATE_DIR="${BABYSITTER_STATE_DIR:-${GLOBAL_ROOT}/state}"
+LOG_DIR="${BABYSITTER_LOG_DIR:-${GLOBAL_ROOT}/logs}"
+LOG_FILE="$LOG_DIR/babysitter-stop-hook.log"
+PROXY_MARKER_FILE="${PLUGIN_ROOT}/.hooks-proxy-install-attempted"
+
+export CURSOR_PLUGIN_ROOT="${CURSOR_PLUGIN_ROOT:-${PLUGIN_ROOT}}"
+export BABYSITTER_STATE_DIR="${STATE_DIR}"
+
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+blog() {
+  local msg="$1"
+  local ts
+  ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  echo "[INFO] $ts $msg" >> "$LOG_FILE" 2>/dev/null
+  if command -v babysitter &>/dev/null; then
+    babysitter log --type hook --label "hook:stop" --message "$msg" --source shell-hook 2>/dev/null || true
+  fi
+}
+
+blog "Unified hook script invoked"
+blog "PLUGIN_ROOT=$PLUGIN_ROOT"
+blog "STATE_DIR=$STATE_DIR"
+
+# Get required version from versions.json (used for hooks-proxy)
+SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${PLUGIN_ROOT}/versions.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}" 2>/dev/null || echo "latest")
+
+# ---------------------------------------------------------------------------
+# Hooks-proxy install (same pattern as SDK install in session-start)
+# ---------------------------------------------------------------------------
+
+install_hooks_proxy() {
+  local target_version="$1"
+  if npm i -g "@a5c-ai/hooks-proxy-cli@${target_version}" --loglevel=error 2>/dev/null; then
+    blog "Installed hooks-proxy globally (${target_version})"
+    return 0
+  else
+    if npm i -g "@a5c-ai/hooks-proxy-cli@${target_version}" --prefix "$HOME/.local" --loglevel=error 2>/dev/null; then
+      export PATH="$HOME/.local/bin:$PATH"
+      blog "Installed hooks-proxy to user prefix (${target_version})"
+      return 0
+    fi
+  fi
+  return 1
+}
+
+# Resolve hooks-proxy binary
+PROXY=""
+if command -v a5c-hooks-proxy &>/dev/null; then
+  PROXY="a5c-hooks-proxy"
+elif [ -f "$HOME/.local/bin/a5c-hooks-proxy" ]; then
+  PROXY="$HOME/.local/bin/a5c-hooks-proxy"
+fi
+
+# Install if not found (only attempt once per plugin version)
+if [ -z "$PROXY" ] && [ ! -f "$PROXY_MARKER_FILE" ]; then
+  blog "hooks-proxy not found, attempting install"
+  install_hooks_proxy "$SDK_VERSION"
+  echo "$SDK_VERSION" > "$PROXY_MARKER_FILE" 2>/dev/null
+  if command -v a5c-hooks-proxy &>/dev/null; then
+    PROXY="a5c-hooks-proxy"
+  elif [ -f "$HOME/.local/bin/a5c-hooks-proxy" ]; then
+    PROXY="$HOME/.local/bin/a5c-hooks-proxy"
+  fi
+fi
+
+# npx fallback if still not found
+if [ -z "$PROXY" ]; then
+  blog "hooks-proxy not found after install, using npx fallback"
+  PROXY="npx -y @a5c-ai/hooks-proxy-cli@${SDK_VERSION} "
+fi
+
+# ---------------------------------------------------------------------------
+# Capture stdin and delegate to hooks-proxy
+# ---------------------------------------------------------------------------
+
+INPUT_FILE=$(mktemp 2>/dev/null || echo "/tmp/cursor-stop-hook-$$.json")
+cat > "$INPUT_FILE"
+
+blog "Hook input received ($(wc -c < "$INPUT_FILE") bytes)"
+
+STDERR_LOG="$LOG_DIR/babysitter-stop-hook-stderr.log"
+
+blog "Using hooks-proxy: $PROXY"
+RESULT=$($PROXY invoke \
+  --adapter cursor \
+  --handler "babysitter hook:run --harness unified --hook-type stop --plugin-root ${CURSOR_PLUGIN_ROOT} --state-dir ${BABYSITTER_STATE_DIR} --json" \
+  --json \
+  < "$INPUT_FILE" 2>"$STDERR_LOG")
+EXIT_CODE=$?
+
+blog "CLI exit code=$EXIT_CODE"
+
+rm -f "$INPUT_FILE" 2>/dev/null
+printf '%s\n' "$RESULT"
+exit $EXIT_CODE

package/hooks/hooks-cursor.json

@@ -4,16 +4,16 @@
     "sessionStart": [
       {
         "type": "command",
-        "bash": "bash \"./hooks/session-start.sh\"",
-        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/session-start.ps1\"",
+        "bash": "bash \"./hooks/babysitter-proxied-session-start.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-session-start.ps1\"",
         "timeoutSec": 30
       }
     ],
     "stop": [
       {
         "type": "command",
-        "bash": "bash \"./hooks/stop-hook.sh\"",
-        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/stop-hook.ps1\"",
+        "bash": "bash \"./hooks/babysitter-proxied-stop-hook.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-stop-hook.ps1\"",
         "loop_limit": null
       }
     ]

package/hooks/hooks-cursor.json.legacy

@@ -0,0 +1,21 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "type": "command",
+        "bash": "bash \"./hooks/session-start.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/session-start.ps1\"",
+        "timeoutSec": 30
+      }
+    ],
+    "stop": [
+      {
+        "type": "command",
+        "bash": "bash \"./hooks/stop-hook.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/stop-hook.ps1\"",
+        "loop_limit": null
+      }
+    ]
+  }
+}

package/hooks/proxied-hooks.json

@@ -0,0 +1,22 @@
+{
+  "_comment": "NOT ACTIVE — Alternative hooks-cursor.json using per-hook unified scripts with hooks-proxy support. To activate, replace hooks-cursor.json with this file.",
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "type": "command",
+        "bash": "bash \"./hooks/babysitter-proxied-session-start.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-session-start.ps1\"",
+        "timeoutSec": 30
+      }
+    ],
+    "stop": [
+      {
+        "type": "command",
+        "bash": "bash \"./hooks/babysitter-proxied-stop-hook.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-stop-hook.ps1\"",
+        "loop_limit": null
+      }
+    ]
+  }
+}

package/hooks.json

@@ -4,16 +4,16 @@
     "sessionStart": [
       {
         "type": "command",
-        "bash": "bash \"./hooks/session-start.sh\"",
-        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/session-start.ps1\"",
+        "bash": "bash \"./hooks/babysitter-proxied-session-start.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-session-start.ps1\"",
         "timeoutSec": 30
       }
     ],
     "stop": [
       {
         "type": "command",
-        "bash": "bash \"./hooks/stop-hook.sh\"",
-        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/stop-hook.ps1\"",
+        "bash": "bash \"./hooks/babysitter-proxied-stop-hook.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-stop-hook.ps1\"",
         "loop_limit": null
       }
     ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a5c-ai/babysitter-cursor",
-  "version": "5.0.1-staging.5cd43600",
+  "version": "5.0.1-staging.6e094dee",
   "description": "Babysitter orchestration plugin for Cursor IDE with SDK-managed process-library bootstrapping and in-turn iteration model",
   "scripts": {
     "test": "node scripts/sync-command-surfaces.js --check",
@@ -44,6 +44,6 @@
   },
   "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-cursor#readme",
   "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.5cd43600"
+    "@a5c-ai/babysitter-sdk": "5.0.1-staging.6e094dee"
   }
 }

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.5cd43600",
+  "version": "5.0.1-staging.6e094dee",
   "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval -- powered by the Babysitter SDK",
   "author": "a5c.ai",
   "license": "MIT",

package/versions.json

@@ -1,3 +1,3 @@
 {
-  "sdkVersion": "5.0.1-staging.5cd43600"
+  "sdkVersion": "5.0.1-staging.6e094dee"
 }