first-plan-engine-bootstrap

Engine Bootstrap

Skill que gerencia o lifecycle do binário nativo first-plan-engine.

Quando ativar

Qualquer command que se beneficia do engine (/fp:cochange, /fp:refresh quando recalcula co-change, /fp:hot em monorepo grande, etc) deve consultar esta skill antes de cair no fallback markdown.

Detecção

Locais onde procurar o binário, na ordem:

1. ${CLAUDE_PLUGIN_ROOT}/engine/bin/first-plan-engine
2. ${HOME}/.local/bin/first-plan-engine
3. $(which first-plan-engine)  # se está no PATH

Verificar via:

ENGINE=""
for candidate in \
  "${CLAUDE_PLUGIN_ROOT}/engine/bin/first-plan-engine" \
  "${HOME}/.local/bin/first-plan-engine" \
  "$(command -v first-plan-engine 2>/dev/null)"; do
  if [ -x "$candidate" ]; then
    ENGINE="$candidate"
    break
  fi
done

Instalação

Se ausente e o command que precisou foi invocado, oferecer:

O command /fp:<X> ficaria 10-100x mais rapido com o engine nativo (Rust binary).
Quer baixar agora? (~5MB, single-file static binary, opt-in)

Opcoes:
A) Sim - download automatico para ${CLAUDE_PLUGIN_ROOT}/engine/bin/
B) Nao - usar fallback markdown (continua funcionando)
C) Manual - instrucoes para download via cargo install ou wget

Download automatico (opcao A)

Detectar arch + OS, baixar release matching:

ARCH=$(uname -m)        # x86_64 ou aarch64
OS=$(uname -s)          # Linux ou Darwin

case "$OS-$ARCH" in
  Linux-x86_64)   TARGET="x86_64-unknown-linux-musl" ;;
  Linux-aarch64)  TARGET="aarch64-unknown-linux-musl" ;;
  Darwin-x86_64)  TARGET="x86_64-apple-darwin" ;;
  Darwin-arm64)   TARGET="aarch64-apple-darwin" ;;
  *)              echo "unsupported: $OS-$ARCH"; exit 1 ;;
esac

DEST="${CLAUDE_PLUGIN_ROOT}/engine/bin"
mkdir -p "$DEST"

URL="https://github.com/vynazevedo/first-plan/releases/latest/download/first-plan-engine-${TARGET}.tar.gz"
curl -fsSL "$URL" | tar xz -C "$DEST"
chmod +x "$DEST/first-plan-engine"

"$DEST/first-plan-engine" --version

Build from source (opcao C)