/plugadvpl:setup

Setup automático: detecta uv, instala se necessário, e roda init + ingest no projeto atual.

Detecção de ambiente Claude Code

Antes de instalar a CLI, detecte se o usuário está usando:

• Claude Code CLI nativo (terminal claude): /plugin install plugadvpl funciona direto no chat.
• Extensão VSCode: /plugin install NÃO funciona (limitação Claude Code). Use a UI Manage Plugins.

Como detectar: rode Bash echo $TERM_PROGRAM — se retornar vscode, está na extensão; senão, provavelmente CLI nativo.

Reporte ao usuário a forma correta de instalar o plugin antes de prosseguir com a CLI.

Execução

Você (Claude) deve rodar os passos abaixo via Bash, sequencialmente, NA PASTA ATUAL do projeto (cwd do usuário):

Passo 1: Verificar uv

if ! command -v uv >/dev/null 2>&1 && ! command -v uvx >/dev/null 2>&1; then
  echo "uv não instalado. Para instalar:"
  case "$(uname -s 2>/dev/null || echo Windows)" in
    Linux*|Darwin*)
      echo "  curl -sSL https://raw.githubusercontent.com/JoniPraia/plugadvpl/main/scripts/install.sh | sh"
      ;;
    *)
      echo "  irm https://raw.githubusercontent.com/JoniPraia/plugadvpl/main/scripts/install.ps1 | iex"
      ;;
  esac
  echo ""
  echo "Após instalar, feche e abra um terminal novo, então rode /plugadvpl:setup de novo."
  exit 0
fi

Passo 2: Garantir plugadvpl instalado

if ! command -v plugadvpl >/dev/null 2>&1; then
  uv tool install plugadvpl
fi
plugadvpl version

Passo 3: Init + Ingest no diretório atual

plugadvpl init
plugadvpl ingest
plugadvpl status

Resultado esperado

Ao final, o diretório atual terá:

• .plugadvpl/index.db (SQLite com índice dos fontes)
• CLAUDE.md com fragmento orientando Claude a consultar o índice antes de ler .prw cru
• .plugadvpl/ adicionado ao .gitignore

Depois disso, comandos como /plugadvpl:arch, /plugadvpl:tables, /plugadvpl:callers ficam disponíveis.

Próximos passos sugeridos

• /plugadvpl:status — ver contagens do índice
• /plugadvpl:arch <arquivo.prw> — visão arquitetural de um fonte
• /plugadvpl:tables SA1 — quem usa a tabela SA1
• /plugadvpl:param MV_LOCALIZA — quem usa esse parâmetro
• /plugadvpl:lint — findings de qualidade