@a5c-ai/babysitter-github 5.0.1-staging.b5c14f2a → 5.0.1-staging.c66885f8

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

@@ -0,0 +1,116 @@
+# Unified Session End Hook for GitHub Copilot CLI (PowerShell)
+# Routes through hooks-proxy for all hook execution.
+#
+# Cleanup and logging on session exit.
+#
+# NOTE: Unlike Claude Code's Stop hook, sessionEnd output is IGNORED by
+# Copilot CLI. This hook cannot block session exit or drive an orchestration
+# loop. It is purely for cleanup and logging.
+
+$ErrorActionPreference = "Continue"
+
+$PluginRoot = if ($env:COPILOT_PLUGIN_DIR) { $env:COPILOT_PLUGIN_DIR } else { Split-Path -Parent $PSScriptRoot }
+$ProxyMarkerFile = Join-Path $PluginRoot ".hooks-proxy-install-attempted"
+
+$GlobalRoot = if ($env:BABYSITTER_GLOBAL_STATE_DIR) { $env:BABYSITTER_GLOBAL_STATE_DIR } else { Join-Path $HOME ".a5c" }
+$LogDir = if ($env:BABYSITTER_LOG_DIR) { $env:BABYSITTER_LOG_DIR } else { Join-Path $GlobalRoot "logs" }
+$LogFile = Join-Path $LogDir "babysitter-session-end-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
+}
+
+Write-Blog "Unified hook script invoked"
+Write-Blog "PLUGIN_ROOT=$PluginRoot"
+
+# 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
+    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-end-hook-stderr.log"
+
+try {
+    if ($Proxy) {
+        Write-Blog "Using hooks-proxy: $Proxy"
+        Get-Content $InputFile | & $Proxy invoke --adapter copilot --handler "babysitter hook:run --harness unified --hook-type session-end --plugin-root $PluginRoot --json" --json 2>$stderrLog | Out-Null
+    } else {
+        Write-Blog "hooks-proxy not found after install, using npx fallback"
+        Get-Content $InputFile | & npx -y "@a5c-ai/hooks-proxy-cli@$SdkVersion" invoke --adapter copilot --handler "babysitter hook:run --harness unified --hook-type session-end --plugin-root $PluginRoot --json" --json 2>$stderrLog | Out-Null
+    }
+} catch {
+    Write-Blog "Hook error: $_"
+}
+
+Write-Blog "Session end hook complete"
+
+Remove-Item $InputFile -Force -ErrorAction SilentlyContinue
+
+exit 0

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

@@ -0,0 +1,112 @@
+#!/bin/bash
+# Unified Session End Hook for GitHub Copilot CLI
+# Routes through hooks-proxy for all hook execution.
+#
+# Cleanup and logging on session exit.
+#
+# NOTE: Unlike Claude Code's Stop hook, sessionEnd output is IGNORED by
+# Copilot CLI. This hook cannot block session exit or drive an orchestration
+# loop. It is purely for cleanup and logging.
+#
+# Protocol:
+#   Input:  JSON via stdin (session context)
+#   Output: IGNORED by Copilot CLI
+#   Exit 0: success (exit code also ignored)
+
+set -uo pipefail
+
+PLUGIN_ROOT="${COPILOT_PLUGIN_DIR:-$(cd "$(dirname "$0")/.." && pwd)}"
+PROXY_MARKER_FILE="${PLUGIN_ROOT}/.hooks-proxy-install-attempted"
+
+GLOBAL_ROOT="${BABYSITTER_GLOBAL_STATE_DIR:-$HOME/.a5c}"
+LOG_DIR="${BABYSITTER_LOG_DIR:-${GLOBAL_ROOT}/logs}"
+LOG_FILE="$LOG_DIR/babysitter-session-end-hook.log"
+
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+# 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")
+
+# Structured logging helper
+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-end" --message "$msg" --source shell-hook 2>/dev/null || true
+  fi
+}
+
+blog "Unified hook script invoked"
+blog "PLUGIN_ROOT=$PLUGIN_ROOT"
+
+# ---------------------------------------------------------------------------
+# 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/hook-session-end-$$.json")
+cat > "$INPUT_FILE"
+
+blog "Hook input received ($(wc -c < "$INPUT_FILE") bytes)"
+
+STDERR_LOG="$LOG_DIR/babysitter-session-end-hook-stderr.log"
+
+# Run cleanup/logging via hooks-proxy; output is ignored by Copilot CLI
+blog "Using hooks-proxy: $PROXY"
+$PROXY invoke \
+  --adapter copilot \
+  --handler "babysitter hook:run --harness unified --hook-type session-end --plugin-root ${PLUGIN_ROOT} --json" \
+  --json \
+  < "$INPUT_FILE" 2>"$STDERR_LOG" || true
+
+blog "Session end hook complete"
+
+rm -f "$INPUT_FILE" 2>/dev/null
+
+exit 0

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

@@ -0,0 +1,189 @@
+# Unified Session Start Hook for GitHub Copilot 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 TypeScript 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:COPILOT_PLUGIN_DIR) { $env:COPILOT_PLUGIN_DIR } else { Split-Path -Parent $PSScriptRoot }
+$SdkMarkerFile = Join-Path $PluginRoot ".babysitter-install-attempted"
+$ProxyMarkerFile = Join-Path $PluginRoot ".hooks-proxy-install-attempted"
+
+$GlobalRoot = if ($env:BABYSITTER_GLOBAL_STATE_DIR) { $env:BABYSITTER_GLOBAL_STATE_DIR } else { Join-Path $HOME ".a5c" }
+$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"
+
+# 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
+}
+
+if (-not (Get-Command babysitter -ErrorAction SilentlyContinue)) {
+    Write-Blog "CLI not found after install, using npx fallback"
+}
+
+# ---------------------------------------------------------------------------
+# 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 copilot --handler "babysitter hook:run --harness unified --hook-type session-start --plugin-root $PluginRoot --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 copilot --handler "babysitter hook:run --harness unified --hook-type session-start --plugin-root $PluginRoot --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,173 @@
+#!/bin/bash
+# Unified Session Start Hook for GitHub Copilot CLI
+# 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 TypeScript 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
+
+PLUGIN_ROOT="${COPILOT_PLUGIN_DIR:-$(cd "$(dirname "$0")/.." && pwd)}"
+SDK_MARKER_FILE="${PLUGIN_ROOT}/.babysitter-install-attempted"
+PROXY_MARKER_FILE="${PLUGIN_ROOT}/.hooks-proxy-install-attempted"
+
+GLOBAL_ROOT="${BABYSITTER_GLOBAL_STATE_DIR:-$HOME/.a5c}"
+LOG_DIR="${BABYSITTER_LOG_DIR:-${GLOBAL_ROOT}/logs}"
+LOG_FILE="$LOG_DIR/babysitter-session-start-hook.log"
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+# Structured logging helper -- writes to both local and global log
+blog() {
+  local msg="$1"
+  local ts
+  ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  echo "[INFO] $ts $msg" >> "$LOG_FILE" 2>/dev/null
+  # Use CLI structured logging when available; fall back to direct append
+  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"
+
+# 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"
+  # Try global install first, fall back to user-local if permissions fail
+  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
+    # Global install failed (permissions) -- try user-local prefix
+    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/hook-session-start-$$.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 copilot \
+  --handler "babysitter hook:run --harness unified --hook-type session-start --plugin-root ${PLUGIN_ROOT} --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-user-prompt-submitted.ps1

@@ -0,0 +1,92 @@
+# Unified userPromptSubmitted Hook for GitHub Copilot CLI (PowerShell)
+# Routes through hooks-proxy for all hook execution.
+#
+# Applies density-filter compression to long user prompts.
+#
+# NOTE: Output from this hook is IGNORED by Copilot CLI.
+# This hook is for logging and side-effects only.
+
+$ErrorActionPreference = "Continue"
+
+$PluginRoot = if ($env:COPILOT_PLUGIN_DIR) { $env:COPILOT_PLUGIN_DIR } else { Split-Path -Parent $PSScriptRoot }
+$ProxyMarkerFile = Join-Path $PluginRoot ".hooks-proxy-install-attempted"
+
+$GlobalRoot = if ($env:BABYSITTER_GLOBAL_STATE_DIR) { $env:BABYSITTER_GLOBAL_STATE_DIR } else { Join-Path $HOME ".a5c" }
+$LogDir = if ($env:BABYSITTER_LOG_DIR) { $env:BABYSITTER_LOG_DIR } else { Join-Path $GlobalRoot "logs" }
+New-Item -ItemType Directory -Path $LogDir -Force -ErrorAction SilentlyContinue | Out-Null
+
+# 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) { 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"
+            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)) {
+    Install-HooksProxy $SdkVersion | Out-Null
+    Set-Content -Path $ProxyMarkerFile -Value $SdkVersion -ErrorAction SilentlyContinue
+    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
+
+$stderrLog = Join-Path $LogDir "babysitter-user-prompt-submitted-hook-stderr.log"
+
+try {
+    if ($Proxy) {
+        Get-Content $InputFile | & $Proxy invoke --adapter copilot --handler "babysitter hook:run --harness unified --hook-type user-prompt-submitted --json" --json 2>$stderrLog | Out-Null
+    } else {
+        Get-Content $InputFile | & npx -y "@a5c-ai/hooks-proxy-cli@$SdkVersion" invoke --adapter copilot --handler "babysitter hook:run --harness unified --hook-type user-prompt-submitted --json" --json 2>$stderrLog | Out-Null
+    }
+} catch {}
+
+Remove-Item $InputFile -Force -ErrorAction SilentlyContinue
+
+exit 0

package/hooks/babysitter-proxied-user-prompt-submitted.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+# Unified userPromptSubmitted Hook for GitHub Copilot CLI
+# Routes through hooks-proxy for all hook execution.
+#
+# Applies density-filter compression to long user prompts.
+# Delegates to SDK CLI: babysitter hook:run --hook-type user-prompt-submitted
+#
+# NOTE: Output from this hook is IGNORED by Copilot CLI.
+# This hook is for logging and side-effects only.
+
+PLUGIN_ROOT="${COPILOT_PLUGIN_DIR:-$(cd "$(dirname "$0")/.." && pwd)}"
+PROXY_MARKER_FILE="${PLUGIN_ROOT}/.hooks-proxy-install-attempted"
+
+GLOBAL_ROOT="${BABYSITTER_GLOBAL_STATE_DIR:-$HOME/.a5c}"
+LOG_DIR="${BABYSITTER_LOG_DIR:-${GLOBAL_ROOT}/logs}"
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+# 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
+    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"
+      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
+  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
+  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/hook-user-prompt-submitted-$$.json")
+cat > "$INPUT_FILE"
+
+if command -v babysitter &>/dev/null; then
+  babysitter log --type hook --label "hook:user-prompt-submitted" --message "Unified hook invoked" --source shell-hook 2>/dev/null || true
+fi
+
+STDERR_LOG="$LOG_DIR/babysitter-user-prompt-submitted-hook-stderr.log"
+
+$PROXY invoke \
+  --adapter copilot \
+  --handler "babysitter hook:run --harness unified --hook-type user-prompt-submitted --json" \
+  --json \
+  < "$INPUT_FILE" 2>"$STDERR_LOG" || true
+
+if command -v babysitter &>/dev/null; then
+  babysitter log --type hook --label "hook:user-prompt-submitted" --message "Hook complete" --source shell-hook 2>/dev/null || true
+fi
+
+rm -f "$INPUT_FILE" 2>/dev/null
+
+exit 0

package/hooks/proxied-hooks.json

@@ -0,0 +1,29 @@
+{
+  "_comment": "NOT ACTIVE — Alternative hook registration using per-hook unified scripts with hooks-proxy support. To activate, update the harness plugin configuration to reference these scripts.",
+  "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
+      }
+    ],
+    "sessionEnd": [
+      {
+        "type": "command",
+        "bash": "bash \"./hooks/babysitter-proxied-session-end.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-session-end.ps1\"",
+        "timeoutSec": 30
+      }
+    ],
+    "userPromptSubmitted": [
+      {
+        "type": "command",
+        "bash": "bash \"./hooks/babysitter-proxied-user-prompt-submitted.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-user-prompt-submitted.ps1\"",
+        "timeoutSec": 15
+      }
+    ]
+  }
+}

package/hooks.json

@@ -4,25 +4,25 @@
     "sessionStart": [
       {
         "type": "command",
-        "bash": "./hooks/session-start.sh",
-        "powershell": "./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
       }
     ],
     "sessionEnd": [
       {
         "type": "command",
-        "bash": "./hooks/session-end.sh",
-        "powershell": "./hooks/session-end.ps1",
+        "bash": "bash \"./hooks/babysitter-proxied-session-end.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-session-end.ps1\"",
         "timeoutSec": 30
       }
     ],
     "userPromptSubmitted": [
       {
         "type": "command",
-        "bash": "./hooks/user-prompt-submitted.sh",
-        "powershell": "./hooks/user-prompt-submitted.ps1",
-        "timeoutSec": 30
+        "bash": "bash \"./hooks/babysitter-proxied-user-prompt-submitted.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-user-prompt-submitted.ps1\"",
+        "timeoutSec": 15
       }
     ]
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a5c-ai/babysitter-github",
-  "version": "5.0.1-staging.b5c14f2a",
+  "version": "5.0.1-staging.c66885f8",
   "description": "Babysitter orchestration plugin for GitHub Copilot CLI with lifecycle hooks and SDK-managed process-library bootstrapping",
   "scripts": {
     "test": "node scripts/sync-command-surfaces.js --check && node test/cloud-agent-install.test.js",
@@ -45,6 +45,6 @@
   },
   "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-github#readme",
   "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.b5c14f2a"
+    "@a5c-ai/babysitter-sdk": "5.0.1-staging.c66885f8"
   }
 }

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.b5c14f2a",
+  "version": "5.0.1-staging.c66885f8",
   "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": {
     "name": "a5c.ai",

package/versions.json

@@ -1,3 +1,3 @@
 {
-  "sdkVersion": "5.0.1-staging.b5c14f2a"
+  "sdkVersion": "5.0.1-staging.c66885f8"
 }