capturar-payloads

Cria/Atualiza:

• Patch na Edge Function adicionando log dedicado controlado por env CAPTURE_PAYLOADS=true
• supabase/functions/_shared/payload-capture.ts — sanitização canônica
• tests/characterization/<edge-fn>/fixtures/payload-NN.json — fixtures sanitizados após drenagem

Após: o user tem fixtures BASEADOS EM DISTRIBUIÇÃO REAL de produção, não em sintéticos. Cobertura comportamental cresce significativamente.

Workflow esperado:

Dia 0:  /capturar-payloads <fn> --mode=instrument
Dia 0:  Você faz deploy + setar CAPTURE_PAYLOADS=true em env
Dia 1-7: produção captura naturalmente
Dia 7:  /capturar-payloads <fn> --mode=drain
Dia 7:  Fixtures criados em tests/characterization/<fn>/fixtures/
Dia 7:  /caracterizar <fn> --fixtures-dir tests/characterization/<fn>/fixtures

Exemplos:

/capturar-payloads supabase/functions/webhook-stripe/index.ts                  # full mode 7 dias
/capturar-payloads supabase/functions/process-orders/index.ts --days 14        # janela maior
/capturar-payloads supabase/functions/process-orders/index.ts --mode=instrument  # só patch
/capturar-payloads supabase/functions/process-orders/index.ts --mode=drain      # só drenagem

Pré-requisitos:

• Edge Function deployada em Supabase (modo drain depende de logs em prod)
• MCP Supabase conectado para drenagem automatizada (alternativa: supabase functions logs CLI)
• Tier full em IDEs com MCP; tier partial degrada para instrumentação only

Quando preferir este comando vs /caracterizar direto:

• Edge Function tem alto traffic (≥ 100 req/dia) — distribuição real cobre edge cases que sintético não pega
• Edge Function tem contrato externo crítico (webhook de Stripe/GitHub) — fidelidade absoluta requer payloads reais
• Equipe quer baseline empírico antes de refactor — payloads reais > inputs sintéticos

1. Parsear argumentos

EDGE_FN_PATH=$(echo "$ARGUMENTS" | awk '{print $1}')
CAPTURE_DAYS=$(echo "$ARGUMENTS" | grep -oE -- '--days [0-9]+' | awk '{print $2}')
MAX_PAYLOADS=$(echo "$ARGUMENTS" | grep -oE -- '--max-payloads [0-9]+' | awk '{print $2}')
MODE=$(echo "$ARGUMENTS" | grep -oE -- '--mode[= ][^ ]+' | sed 's/--mode[= ]//')
SANITIZE_KEYS=$(echo "$ARGUMENTS" | grep -oE -- '--sanitize-keys [^ ]+' | awk '{print $2}')

[ -z "$CAPTURE_DAYS" ]  && CAPTURE_DAYS=7
[ -z "$MAX_PAYLOADS" ]  && MAX_PAYLOADS=100
[ -z "$MODE" ]          && MODE="full"

if [ -z "$EDGE_FN_PATH" ]; then
  echo "ERROR: edge_function_path obrigatório"
  echo "Uso: /capturar-payloads <path> [opções]"
  exit 1
fi

if [ ! -f "$EDGE_FN_PATH" ]; then
  echo "ERROR: arquivo não encontrado: $EDGE_FN_PATH"
  exit 1
fi