scripts/butler-extension-ext4-preflight.sh

Rama main · réplica de lectura del repositorio original.

#!/usr/bin/env bash
# EXT-4 preflight: GitHub OpenAPI MCP (path A) readiness.
set -euo pipefail

ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT"
export PYTHONPATH="$ROOT"

# shellcheck source=scripts/lib/butler-source-env.sh
source "$ROOT/scripts/lib/butler-source-env.sh"
butler_source_env "$ROOT/.env" 2>/dev/null || true

ok=0
warn=0
fail=0

_pass() { printf '  [ok] %s\n' "$1"; ok=$((ok + 1)); }
_warn() { printf '  [warn] %s\n' "$1"; warn=$((warn + 1)); }
_fail() { printf '  [fail] %s\n' "$1"; fail=$((fail + 1)); }

echo "EXT-4 GitHub OpenAPI MCP preflight"

if command -v node >/dev/null 2>&1; then
  node_ver="$(node --version 2>/dev/null | sed 's/^v//' || echo '0')"
  node_major="${node_ver%%.*}"
  if [[ "${node_major:-0}" -ge 18 ]]; then
    _pass "node: $(command -v node) (v${node_ver})"
  else
    _warn "node v${node_ver} < 18"
  fi
else
  _fail "node not in PATH"
fi

if command -v npx >/dev/null 2>&1; then
  _pass "npx: $(command -v npx)"
else
  _fail "npx not in PATH"
fi

if PYTHONPATH="$ROOT" python3 -c "import mcp" 2>/dev/null; then
  _pass "python mcp SDK installed"
else
  _fail "pip install butler-system[mcp]"
fi

if [[ "${BUTLER_MCP_ENABLED:-0}" == "1" ]]; then
  _pass "BUTLER_MCP_ENABLED=1"
else
  _warn "BUTLER_MCP_ENABLED not 1"
fi

case "${BUTLER_MCP_STDIO_ALLOW_COMMANDS:-python,python3,uvx}" in
  *npx*) _pass "BUTLER_MCP_STDIO_ALLOW_COMMANDS includes npx" ;;
  *) _warn "BUTLER_MCP_STDIO_ALLOW_COMMANDS lacks npx" ;;
esac

repo_spec="$ROOT/.butler/openapi/github-readonly.yml"
pin_spec="$HOME/.butler/openapi/github-readonly.yml"
if [[ -f "$pin_spec" ]]; then
  _pass "pinned OpenAPI spec: $pin_spec"
elif [[ -f "$repo_spec" ]]; then
  _warn "spec not pinned — run: bash scripts/butler-github-openapi-spec-install.sh"
else
  _fail "missing repo spec at $repo_spec"
fi

token="${GITHUB_TOKEN:-${GITHUB_PERSONAL_ACCESS_TOKEN:-}}"
secrets_token=""
if [[ -f "${BUTLER_SECRETS_PATH:-$HOME/.butler/secrets.yaml}" ]]; then
  secrets_token="$(python3 - "${BUTLER_SECRETS_PATH:-$HOME/.butler/secrets.yaml}" <<'PY'
import sys
from pathlib import Path
import yaml
path = Path(sys.argv[1])
if not path.is_file():
    sys.exit(0)
data = yaml.safe_load(path.read_text(encoding="utf-8")) or {}
for key in ("GITHUB_TOKEN", "GITHUB_PERSONAL_ACCESS_TOKEN"):
    val = str(data.get(key) or "").strip()
    if val:
        print(val)
        break
PY
)"
fi
if [[ -n "$token" ]]; then
  _pass "GITHUB_TOKEN set (len=${#token})"
elif [[ -n "$secrets_token" ]]; then
  if [[ "${BUTLER_MCP_ENABLED:-0}" == "1" ]]; then
    _fail "GITHUB_TOKEN in secrets.yaml but not process env — run: bash scripts/butler-github-token-sync.sh"
  else
    _warn "GITHUB_TOKEN only in secrets.yaml — sync before MCP live calls"
  fi
else
  if [[ "${BUTLER_MCP_ENABLED:-0}" == "1" ]]; then
    _fail "GITHUB_TOKEN unset — add to ~/.butler/secrets.yaml then bash scripts/butler-github-token-sync.sh"
  else
    _warn "GITHUB_TOKEN unset — add to ~/.butler/secrets.yaml or .env before live calls"
  fi
fi

found_github=0
for cfg in "$HOME/.butler/mcp.yaml" "$ROOT/.butler/mcp.yaml"; do
  if [[ -f "$cfg" ]] && grep -qE '^[[:space:]]*github:' "$cfg" 2>/dev/null; then
    _pass "github block in $cfg"
    found_github=1
    break
  fi
done
if [[ "$found_github" -eq 0 ]]; then
  _warn "no github server in mcp.yaml — run: bash scripts/butler-extension-ext4-integrate.sh"
fi

echo ""
echo "summary: ok=$ok warn=$warn fail=$fail"
if [[ "$fail" -gt 0 ]]; then
  echo "See docs/plans/active/extension-candidates/ext-4-second-openapi-2026-06.md"
  exit 1
fi
exit 0