detectar-duplicacao

Invoca o agente shotgun-surgery-detector que aplica a skill legacy-shotgun-surgery. Output: clusters priorizados por (size × frequency × extract feasibility).

Cria/Atualiza:

• .planning/SHOTGUN-SURGERY.md — clusters detectados, top 10 priorizados, sugestões extract

Após: o user tem lista acionável de candidates a extract method/class para reduzir change points. PR sequence canônica: extract first → modify second.

Exemplos:

/detectar-duplicacao src/                                              # both modes, defaults
/detectar-duplicacao . --mode=syntactic                                # só Feathers original (sem custo IA)
/detectar-duplicacao src/ --threshold 0.90                              # mais conservador
/detectar-duplicacao src/ --min-cluster-size 5                         # só clusters grandes
/detectar-duplicacao src/ --provider=pgvector                          # forçar self-hosted

Pré-requisitos:

• jscpd disponível para sintática (npm install -g jscpd se não)
• OPENAI_API_KEY OR pgvector setup para semântica (auto-detect)
• Node.js 20+ no path para chamadas embeddings

Quando este comando é o caminho:

• Você sente "estou mudando isso em N lugares" — use detector pra confirmar/quantificar
• Refactor proposto inclui extract method/class — detector confirma 3+ ocorrências
• Code review onde reviewer suspeita de DRY violations
• Pré-requisito para /legacy refactor quando shotgun é a real causa raiz

1. Parsear argumentos

ROOT_DIR=$(echo "$ARGUMENTS" | awk '{print $1}')
THRESHOLD=$(echo "$ARGUMENTS" | grep -oE -- '--threshold [0-9.]+' | awk '{print $2}')
MIN_CLUSTER=$(echo "$ARGUMENTS" | grep -oE -- '--min-cluster-size [0-9]+' | awk '{print $2}')
MIN_BLOCK=$(echo "$ARGUMENTS" | grep -oE -- '--min-block-lines [0-9]+' | awk '{print $2}')
MODE=$(echo "$ARGUMENTS" | grep -oE -- '--mode[= ][^ ]+' | sed 's/--mode[= ]//')
PROVIDER=$(echo "$ARGUMENTS" | grep -oE -- '--provider[= ][^ ]+' | sed 's/--provider[= ]//')
OUTPUT_PATH=$(echo "$ARGUMENTS" | grep -oE -- '--output [^ ]+' | awk '{print $2}')

[ -z "$ROOT_DIR" ]     && ROOT_DIR="."
[ -z "$THRESHOLD" ]    && THRESHOLD="0.85"
[ -z "$MIN_CLUSTER" ]  && MIN_CLUSTER=3
[ -z "$MIN_BLOCK" ]    && MIN_BLOCK=10
[ -z "$MODE" ]         && MODE="both"
[ -z "$PROVIDER" ]     && PROVIDER="auto"
[ -z "$OUTPUT_PATH" ]  && OUTPUT_PATH=".planning/SHOTGUN-SURGERY.md"

if [ ! -d "$ROOT_DIR" ]; then
  echo "ERROR: root_dir não encontrado: $ROOT_DIR"
  exit 1
fi

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