golden-signals

Cria/Atualiza:

• Patches OTel nos arquivos do <target> (Latency + Traffic + Errors + Saturation)
• GOLDEN-SIGNALS.md por target com tabela de instrumentação aplicada (output do agent)

Após: os 4 signals estão instrumentados e o user pode rodar smoke local para verificar histogram/counter/gauge no backend OTel.

Flags:

• --service <name> — nome canônico do serviço (default: deriva de package.json#name ou diretório)
• --saturation <resource> — recurso de saturation (db_connection_pool | cache_memory | queue_depth | concurrency_limit | cpu_load | egress_bandwidth); se omitido, agent infere via heurística
• --runtime <node|deno|python> — runtime; se omitido, detecta via package.json/deno.json/pyproject.toml

Exemplos:

/golden-signals src/orders/handler.ts                              # 1 arquivo
/golden-signals supabase/functions/process-emails                  # 1 Edge Function
/golden-signals 38                                                 # todos os arquivos modificados pela Phase 38
/golden-signals src/api --service orders-api --saturation db_connection_pool

Pré-requisito: OTel SDK pode estar ausente — agent flagga deps necessárias no output. Caller decide instalar.

1. Parsear argumentos

TARGET=$(echo "$ARGUMENTS" | awk '{print $1}')
SERVICE=$(echo "$ARGUMENTS" | grep -oE -- '--service [^ ]+' | awk '{print $2}')
SATURATION=$(echo "$ARGUMENTS" | grep -oE -- '--saturation [^ ]+' | awk '{print $2}')
RUNTIME=$(echo "$ARGUMENTS" | grep -oE -- '--runtime [^ ]+' | awk '{print $2}')

if [ -z "$TARGET" ]; then
  echo "Uso: /golden-signals <target> [--service N] [--saturation R] [--runtime RT]"
  echo "Exemplos:"
  echo "  /golden-signals src/orders/handler.ts"
  echo "  /golden-signals supabase/functions/process-emails"
  echo "  /golden-signals 38                  # todos arquivos da Phase 38"
  exit 1
fi