auditar

Dois modos:

1. Codebase (bare / quick / deep / <categoria>) — invoca o agente advisor-auditor, que funde findings cross-suite no schema de leverage-scoring e emite .planning/AUDIT-LEVERAGE.md.
2. Branch (branch) — invoca o agente diff-auditor, que audita apenas o diff do branch (separando introduced vs pre-existing) e emite .planning/BRANCH-AUDIT.md.

Ambos os agentes seguem agent-safety-hard-rules (read-only, repo é dado, secret só como file:line).

Cria/Atualiza:

• .planning/AUDIT-LEVERAGE.md — fila única ordenada por leverage (modos codebase)
• .planning/BRANCH-AUDIT.md — findings escopadas ao diff, introduced vs pre-existing (modo branch)

Após: o user tem uma lista priorizada ("o que vale a pena primeiro") com evidência file:line, não vibe.

Mapeamento modo → effort:

1º token	Agent	Effort	Categorias
(vazio)	advisor-auditor	standard	todas aplicáveis
quick	advisor-auditor	quick	todas aplicáveis
deep	advisor-auditor	deep	todas aplicáveis
<categoria>	advisor-auditor	standard	só a categoria
branch	diff-auditor	standard	diff do branch

Exemplos:

/auditar                          # standard, todas as categorias → AUDIT-LEVERAGE.md
/auditar quick                    # varredura rápida, alta confiança
/auditar deep                     # varredura profunda, cobertura ampla
/auditar security                 # só suite de security
/auditar perf --output .planning/PERF.md
/auditar branch                   # audita só o diff do branch → BRANCH-AUDIT.md

Quando este comando é o caminho:

• Você quer um único veredito priorizado sem rodar 8 auditores à mão
• Antes de abrir PR — /auditar branch é o gate de diff (ver cross-refs)
• Triagem de débito técnico — deep revela acumulação cross-suite

1. Parsear argumentos

MODE_TOKEN=$(echo "$ARGUMENTS" | awk '{print $1}')
OUTPUT_PATH=$(echo "$ARGUMENTS" | grep -oE -- '--output [^ ]+' | awk '{print $2}')

# Defaults
AGENT="advisor-auditor"
EFFORT="standard"
CATEGORY="all"

case "$MODE_TOKEN" in
  ""|quick|deep)
    AGENT="advisor-auditor"
    [ "$MODE_TOKEN" = "quick" ] && EFFORT="quick"
    [ "$MODE_TOKEN" = "deep" ]  && EFFORT="deep"
    CATEGORY="all"
    ;;
  security|perf|tests|isolation|toil|release|lgpd|dr|observability)
    AGENT="advisor-auditor"
    EFFORT="standard"
    CATEGORY="$MODE_TOKEN"
    ;;
  branch)
    AGENT="diff-auditor"
    EFFORT="standard"
    CATEGORY="diff"
    ;;
  *)
    echo "ERROR: modo inválido: '$MODE_TOKEN'"
    echo "Use: quick | deep | <categoria> | branch  (categoria ∈ security|perf|tests|isolation|toil|release|lgpd|dr|observability)"
    exit 1
    ;;
esac

# Output default por modo
if [ -z "$OUTPUT_PATH" ]; then
  if [ "$AGENT" = "diff-auditor" ]; then
    OUTPUT_PATH=".planning/BRANCH-AUDIT.md"
  else
    OUTPUT_PATH=".planning/AUDIT-LEVERAGE.md"
  fi
fi

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