auditar-observabilidade-cobertura

• Edge functions emitindo 4 golden signals: X / N
• Edge functions com SLO definido: Y / N
• Edge functions com burn rate alert: Z / N
• Edge functions com characterization tests: W / N
• Top 5 funções mais críticas (por chamadas 30d) sem cobertura completa

Invoca o agente observability-coverage-auditor que cross-references skills v1.9 + v1.10 + v1.12.

Cria/Atualiza:

• .planning/OBSERVABILITY-COVERAGE.md — relatório scored com tabela X/N por dimensão + top críticas + recomendações priorizadas

Após: o user vê tamanho do buraco quantitativamente e tem fila ordenada por (traffic × missing dimensions). As 2 que ele instrumentou às pressas viram baseline; as outras N entram na fila ordenada.

Exemplos:

/auditar-observabilidade-cobertura                                    # defaults
/auditar-observabilidade-cobertura --top-n 10                         # listar top 10
/auditar-observabilidade-cobertura --dimensions signals,slo           # só 2 dimensões
/auditar-observabilidade-cobertura --traffic-window 7d                # janela menor

Pré-requisitos:

• Projeto Supabase (supabase/config.toml presente)
• MCP Supabase conectado para traffic data + Edge Functions list (recomendado)
• Sem MCP: agent reverte para enumerate via filesystem (sem traffic data → top-N por filesystem only)

Quando este comando é o caminho:

• Você quer "ver o buraco" antes de priorizar instrumentação
• Você instrumentou algumas Edge Functions ad-hoc; agora quer audit estruturado das outras
• Audit trimestral cross-suite
• Pré-requisito de /concluir-marco quando workflow.observability_coverage_threshold opt-in
• /auditar-marco chain (audit milestone consume este)

1. Parsear argumentos

TRAFFIC_WINDOW=$(echo "$ARGUMENTS" | grep -oE -- '--traffic-window [^ ]+' | awk '{print $2}')
TOP_N=$(echo "$ARGUMENTS" | grep -oE -- '--top-n [0-9]+' | awk '{print $2}')
DIMENSIONS=$(echo "$ARGUMENTS" | grep -oE -- '--dimensions [^ ]+' | awk '{print $2}')
OUTPUT_PATH=$(echo "$ARGUMENTS" | grep -oE -- '--output [^ ]+' | awk '{print $2}')

[ -z "$TRAFFIC_WINDOW" ] && TRAFFIC_WINDOW="30d"
[ -z "$TOP_N" ]          && TOP_N=5
[ -z "$DIMENSIONS" ]     && DIMENSIONS="signals,slo,burn-alert,characterization"
[ -z "$OUTPUT_PATH" ]    && OUTPUT_PATH=".planning/OBSERVABILITY-COVERAGE.md"

mkdir -p "$(dirname "$OUTPUT_PATH")"